- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add notque/vexjoy-agent --skill joy-check -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add notque/vexjoy-agent --skill joy-check -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add notque/vexjoy-agent --skill joy-check -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add notque/vexjoy-agent --skill joy-check -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/notque/vexjoy-agent/tree/HEAD/skills/code-quality/joy-checkDe l'éditeur
Two modes:
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.
Auto-detection (priority order):
--mode flag → use thatagents/*.md → instructionskills/**/SKILL.md → instructionskills/process/workflow/references/*.md → instructionCLAUDE.md or README.md → instructionLoad references/{mode}-rubric.md for scoring criteria and examples.
GATE: Mode determined, rubric loaded.
Regex scanning as a fast gate before LLM semantic analysis.
Writing mode:
python3 ~/.claude/scripts/scan-negative-framing.py [file]
Instruction mode:
grep -nE 'NEVER|do NOT|must NOT|FORBIDDEN' [file]
grep -nE "^-?\s*Don't|^-?\s*Avoid|^#+.*Anti-[Pp]attern|^#+.*Avoid" [file]
Report findings with reframe suggestions from the rubric. If --fix, apply reframes and re-run.
GATE: Zero regex/grep hits. Resolve obvious patterns before Phase 2.
Step 1: Read content
Read full file. Skip frontmatter and code blocks.
Step 2: Evaluate against rubric
Apply scoring dimensions from references/{mode}-rubric.md.
For writing: Joy-grievance lens. Watch for subtle patterns in references/writing-rubric.md (defensive disclaimers, accumulative grievance, passive-aggressive factuality, reluctant generosity).
For instruction: Positive-negative lens. Check against patterns table in references/instruction-rubric.md. Contextual exceptions: subordinate negatives attached to positive instructions are PASS, as are negatives in code examples, writing samples, and technical terms.
Step 3: Score each item
Apply the rubric's scoring scale. For items scoring CAUTION/GRIEVANCE (writing) or NEGATIVE-LEANING/PROHIBITION-HEAVY (instruction), draft specific reframe suggestions preserving substance.
If an item seems "too subtle to flag" — that is precisely when flagging matters. Subtle patterns are the primary purpose of this LLM phase.
GATE: All items scored. Reframe suggestions drafted for flagged items.
Step 1: Calculate overall score
Average all item scores. Pass criteria:
Step 2: Output
JOY CHECK: [file]
Mode: [writing|instruction]
Score: [0-100]
Status: PASS / FAIL
Items:
[writing mode]
P1 (L10-12): JOY [85] -- explorer framing, curiosity
P3 (L18-22): CAUTION [40] -- "confused" leans defensive
-> Reframe: Focus on what you learned from the confusion
[instruction mode]
L33: NEGATIVE [20] -- "NEVER edit code directly"
-> Rewrite: "Route all code modifications to domain agents"
L45: PASS [90] -- "Create feature branches for all changes"
L78: PASS [85] -- "Credentials stay in .env files, never in code" (subordinate negative OK)
Overall: [summary of framing arc]
Step 3: Fix mode
If --fix:
GATE: Report produced. If --fix, all rewrites applied and re-verified.
Writing pipeline:
CONTENT --> writing workflow --> scan-ai-patterns --> joy-check --mode writing
Instruction pipeline:
SKILL.md --> joy-check --mode instruction --> fix flagged patterns --> re-verify
Auto-invocation points:
toolkit: after generating a new skillagent-upgrade: after modifying an agentwriting: during validationdoc-pipeline: for toolkit documentationInvoke standalone via /joy-check [file] (auto-detects mode) or with explicit --mode.
Verify path with ls -la. Use glob to search: Glob **/*.md. Confirm working directory.
Verify scripts/scan-negative-framing.py exists. Requires Python 3.10+. If unavailable, skip to Phase 2 — the pre-filter is an optimization, not a requirement.
Content is fundamentally grievance-framed. Report scores honestly. Suggest full rewrite with different framing premise, not paragraph-level fixes.
Output best version with remaining concerns. Explain which rubric dimensions resist correction. The framing premise itself may need rethinking.
references/writing-rubric.md — Joy-grievance spectrum, subtle patterns, scoring, examplesreferences/instruction-rubric.md — Positive framing rules, patterns, rewrite strategies, examplesscan-negative-framing.py — Regex pre-filter for grievance patterns (writing mode, Phase 1)writing — Voice, prose quality, and content validationtoolkit — Skill creation and instruction validationValidate content framing on joy-grievance spectrum.
---name: joy-checkdescription: Validate content framing on joy-grievance spectrum.---# skills/code-quality/joy-check/SKILL.mdFAQ
Téléchargez skills/code-quality/joy-check/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/notque/vexjoy-agent.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.