Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A clean, well-structured instruction-only skill with concrete slash-command guidance and clear detection scenarios. The main improvement is reducing repetition between the Detection Logic, Quick Reference, and Notes sections.
Suggestions
Collapse the 'Quick Reference' table into the Detection Logic section or remove it, since it duplicates the per-scenario suggestions already shown above.
Merge the 'Notes' section into 'Purpose' to avoid restating 'only suggests, never modifies' and the single-source-of-truth point twice.
Optionally convert the illustrative detection blocks (e.g. 'docs/PLAN.md last modified: 5 days ago') into a compact checklist so the actionable signal is even denser.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows, but the 'Quick Reference' table largely restates the Detection Logic scenarios and the 'Notes' section repeats the Purpose/never-modifies point, so it could be tightened; this matches the 'mostly efficient but could be tightened' anchor. | 2 / 3 |
Actionability | Guidance is concrete and copy-paste ready with specific slash commands ('/sync --git', '/save "notes"', '/save --archive') and precise staleness heuristics (>3 days, commits since, feat:/fix:/refactor:); as an instruction-only skill this satisfies the actionable bar without executable code. | 3 / 3 |
Workflow Clarity | The detect-then-suggest flow is laid out unambiguously across four enumerated scenarios (Plan Missing, Plan Stale, Uncommitted Work, Session Start), and as a suggest-only skill with no destructive or batch operations the missing-validation cap does not apply. | 3 / 3 |
Progressive Disclosure | A single well-organized file with clearly headed sections (Purpose, Detection Logic, Quick Reference, Staleness Heuristics, Notes) and no nested external references; with no bundle files present, the well-organized single-file structure meets the level-3 bar for simple skills. | 3 / 3 |
Total | 11 / 12 Passed |