joy-check

Installation
SKILL.md

Joy Check

Validate content framing using mode-specific rubrics. Two modes:

  • writing — Joy-grievance spectrum for human-facing content (blog posts, emails, articles). Evaluates whether content frames experiences through curiosity and generosity rather than grievance and accusation.
  • instruction — Positive framing validation for LLM-facing content (agents, skills, pipelines). Evaluates whether instructions tell the reader what to do rather than what to avoid (ADR-127).

By default the skill evaluates each paragraph/instruction independently, produces a score (0-100), and suggests reframes without modifying content. Optional flags: --fix rewrites flagged items in place and re-verifies; --strict fails on any item below 60; --mode writing|instruction overrides auto-detection.

This skill checks framing, not topic and not voice. Voice fidelity belongs to voice-validator, AI pattern detection belongs to anti-ai-editor.

Reference Loading Table

Signal Load These Files Why
tasks related to this reference instruction-rubric.md Loads detailed guidance from instruction-rubric.md.
tasks related to this reference writing-rubric.md Loads detailed guidance from writing-rubric.md.

Instructions

Related skills
Installs
7
GitHub Stars
366
First Seen
Mar 23, 2026