Content
71%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strongly actionable audit skill with concrete files, thresholds, code, and an exact report template, sequenced clearly across six checks. Its weaknesses are redundancy (cheatsheet/Mindset/Anti-Patterns sections and author-specific asides) and an orphaned references/checklist.md that the body never points to, which undermine both conciseness and progressive disclosure.
Suggestions
Link the bundle reference from the body (e.g., "Full checklist: see [checklist.md](references/checklist.md)") and move the duplicated cheatsheet table and Anti-Patterns content into it, keeping SKILL.md as the lean overview.
Trim author-specific details ("like the personalOS repo", "granola meeting sync") into generic examples, and cut or compress the "Mindset" section since it restates ordering concepts the checks already encode.
Add explicit handling for missing inputs — what to report when ~/.claude/settings.json, hook files, or MCP configs are absent, and how to resolve Check 6's "MANUAL CHECK" outcome.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The six checks themselves are tight and information-dense, but the body carries notable redundancy beyond them: a "Reference: The 6 Rules (Quick Cheatsheet)" table that restates all six checks, plus "Mindset" and "Anti-Patterns" sections that re-explain caching ordering concepts Claude already knows ("stable content first, volatile content last"). Author-specific details like "(like the personalOS repo)" and "granola meeting sync" also pad tokens without general use. This fits anchor 3 (mostly efficient but some unnecessary explanation that could be tightened) better than anchor 4's minor-instance bar. | 3 / 5 |
Actionability | Every check names the exact files to read ("~/.claude/settings.json", "SessionStart and UserPromptSubmit hook files"), the exact pattern to verify ("hookSpecificOutput.additionalContext"), numeric thresholds ("< 2k chars ... 2k–10k ... > 10k chars"), a copy-paste-ready bash snippet for trimming git status, and a literal report template to emit. This matches anchor 5: fully executable, copy-paste-ready, covering the common cases. | 5 / 5 |
Workflow Clarity | The sequence is unambiguous: "Run all checks automatically... produce the full report in one pass", then checks 1–6 in order, then a defined output format, with each check carrying its own PASS/WARNING/FAIL scoring criteria acting as evaluation checkpoints. It falls short of anchor 5 because there are no explicit feedback/validation steps — e.g., what to do when a listed file is missing, no hooks are configured, or a check is indeterminate (Check 6 ends in "MANUAL CHECK" with no instruction for how to resolve it). | 4 / 5 |
Progressive Disclosure | Internal sectioning is decent (per-check headers, output format, cheatsheet), but the bundle contains references/checklist.md and the SKILL.md body never cites it — the single reference is present but not signaled at all, and checklist.md itself says "Core guidance is in SKILL.md" while nothing points back. Duplicated content (the cheatsheet table, anti-patterns) is inlined where the reference file would be the natural home. This matches anchor 3 (references present but not clearly signaled; content that should be separate is inline). | 3 / 5 |
Total | 15 / 20 Passed |