Content
96%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.
An exemplary lean, highly actionable skill body: exact tool invocation with sample output, a sequenced workflow with error-recovery branches, anti-patterns, and a verification checklist. The only defect is the dangling TROUBLESHOOTING.md reference, which is the one thing holding progressive_disclosure back from full marks.
Suggestions
Fix the dangling reference at the Troubleshooting section: TROUBLESHOOTING.md does not exist in the bundle (no references/ directory) — either add the file with the memory_sessions fallback steps or remove the link and inline one fallback instruction.
The Checklist partially restates Workflow requirements; that is acceptable as self-verification, but merging the two observation-count rules into one checklist item would trim a few tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place: the Quick start gives the exact tool call and expected output, the Why section states a real failure mode in two lines, and Workflow/Anti-patterns/Checklist each serve distinct purposes with no padding. There is no explanation of concepts Claude already knows, matching the 'Lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | The Quick start is copy-paste-ready ("memory_sessions { \"project\": \"<current-project-id>\", \"limit\": 20 }") with a concrete expected-output example showing the exact display format, and the workflow steps include precise executable details (page via `nextCursor`, show first 8 chars of session id, reverse chronological order, limit 20). This fully covers the common case per the score-5 anchor for an instruction skill. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence with explicit error-recovery branches (unknown project id → page via `nextCursor` and match normalized `cwd` by directory boundary; state when a partial page is displayed; tool unavailable → Troubleshooting doc) plus a self-verification Checklist. The operation is read-only, so the destructive/batch cap does not apply; this matches the score-5 anchor with feedback loops and a checklist. | 5 / 5 |
Progressive Disclosure | Sections are well organized (Quick start, Why, Workflow, Anti-patterns, Checklist, See also, Troubleshooting) and the single external reference is clearly signaled and one level deep. However, the link "See [TROUBLESHOOTING.md](TROUBLESHOOTING.md)" points to a file that does not exist anywhere in the bundle, a real organization gap; and the body exceeds 50 lines, so the simple-skill exception for an automatic 5 does not apply — fitting 'Good structure... minor organization gaps' rather than score 5. | 4 / 5 |
Total | 19 / 20 Passed |