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 the private de-AI editor skill.

Reference Loading Table

Signal Load These Files Why
scoring instruction files (agents, skills, pipelines): positive-framing rubric instruction-rubric.md Loads detailed guidance from instruction-rubric.md.
scoring human-facing prose (blog posts, emails, docs): joy-grievance rubric writing-rubric.md Loads detailed guidance from writing-rubric.md.

Instructions

Installs
13
GitHub Stars
416
First Seen
Mar 23, 2026
joy-check — notque/vexjoy-agent