Content
86%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 well-structured tool skill: fully executable command examples, an explicit note lifecycle with clear save/recall/applied semantics, and exemplary progressive disclosure that scopes each reference to a specific need. The only trims available are the thrice-repeated bump-semantics explanations and missing error-handling guidance for destructive commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and entirely tool-specific (lifespan semantics, use signals, path rules) — no explanations of concepts Claude already knows. Not 5 because the find/show/used bump semantics are repeated in three places (Quick reference comments, 'When to call used', and 'Hard rules'); not 3 since there is no general-knowledge padding. | 4 / 5 |
Actionability | Every subcommand is shown as an executable example with realistic arguments (e.g. 'agent-carnet save deps/iconv-issue --summary ... --agent claude-code --tags compat,esm'), plus a concrete discovery mechanism ('agent-carnet <command> -h'). Copy-paste ready and covering the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The lifecycle is clearly sequenced ('When to save' -> 'When to recall' -> 'When to call used') with explicit decision criteria, and destructive operations are buffered ('deleted carnets land in .carnet/.trash/ for 7 days before hard delete'). Not 5: no error/invalid-path handling is shown for commands like 'rm <path> --yes'; not 3 because sequencing and checkpoints are explicit. | 4 / 5 |
Progressive Disclosure | The body states it is self-sufficient ('This SKILL.md is enough for everyday note-keeping'), then gives a condition-scoped table pointing to exactly two real one-level-deep references (references/cookbook.md, references/frontmatter.md) with explicit anti-speculative guidance ('do not read them speculatively'). This matches the top anchor for a clear overview with well-signaled references. | 5 / 5 |
Total | 18 / 20 Passed |