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, executable CLI skill body with strong actionability and exemplary progressive disclosure. The only friction is mild restatement of the use-signal semantics across sections.
Suggestions
Consolidate the weak-vs-strong signal / last_used bumping rules into one canonical location (Hard rules) and reference it from the other sections instead of restating.
Add a one-line pre-check before `agent-carnet rm` (e.g. confirm the path with `agent-carnet show` first) to make the destructive step's validation explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but the weak-vs-strong use-signal and "show bumps last_used" semantics are restated across the Quick reference, "When to call used", and "Hard rules" sections — minor trimming opportunity. | 4 / 5 |
Actionability | The Quick reference gives copy-paste-ready bash with real arguments, flags, tags, and paths covering save/find/list/show/used/move/rm, plus a pointer to per-subcommand `-h` help. | 5 / 5 |
Workflow Clarity | Clear when-to-save/recall/used decision guidance with explicit signal semantics; destructive `rm` is mitigated by the 7-day `.trash/` safety net and `--yes` gate, leaving only minor explicit-validation gaps. | 4 / 5 |
Progressive Disclosure | A focused overview with a "When to read references/" table mapping specific conditions to one-level-deep, real reference files (cookbook.md, frontmatter.md) and an explicit "do not read references/ speculatively" guard. | 5 / 5 |
Total | 18 / 20 Passed |