joy-check
Installation
SKILL.md
Joy Check
Two modes:
- writing — Joy-grievance spectrum for human-facing content (blog posts, emails, articles). Evaluates curiosity/generosity vs. grievance/accusation framing.
- instruction — Positive framing for LLM-facing content (agents, skills, pipelines). Evaluates "what to do" vs. "what to avoid" (ADR-127).
Evaluates each paragraph/instruction independently, produces a score (0-100), suggests reframes without modifying content. Flags: --fix rewrites flagged items in place and re-verifies; --strict fails on any item below 60; --mode writing|instruction overrides auto-detection.
Checks framing, not topic or voice. The writing workflow owns voice fidelity and AI-pattern detection.
Reference Loading Table
| Signal | Load These Files | Why |
|---|---|---|
| Scoring agents, skills, pipelines, or toolkit documentation | references/instruction-rubric.md |
Positive-framing patterns, scoring, and examples. |
| Scoring articles, emails, posts, or other human-facing prose | references/writing-rubric.md |
Joy-grievance patterns, scoring, and examples. |