Content
81%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 highly actionable, well-sequenced operational skill: exact commands, explicit fail-closed validation rules, and a concrete output template. Its main weakness is conciseness — the Gotchas section re-states several rules already given in the phases, and version-pinned CLI contract details are inlined rather than isolated.
Suggestions
De-duplicate rules repeated between the phases and Gotchas ("Hooks should never spam the user", alias set-alias commands, chmod 600/privacy, "never invent history") — state each rule once and keep Gotchas for genuinely new edge cases only.
Move the version-pinned CLI stream-handling contract ("Today (0.8.0)") into a dedicated CLI-contract reference file or an 'old patterns' section so version churn does not age the skill body.
Drop the contributor-facing maintenance instruction ("update this skill in the same PR that ships the CLI change") from the runtime skill body — it guides skill maintainers, not skill execution.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational, but several points are stated twice — "Hooks should never spam the user" appears in Phase 0 and again in Gotchas, the alias `set-alias` commands appear in Phase 0 and Gotchas, "chmod 600"/privacy appears in Phase 4 and Gotchas, and "never invent history" appears in both the Phase 3 rules and Gotchas. It also embeds time-sensitive version information ("Today (0.8.0)") and a contributor-facing maintenance instruction ("update this skill in the same PR that ships the CLI change") inline, which fits the 3 anchor (mostly efficient but could be tightened) rather than 4. It is not a 2 because nothing explains concepts Claude already knows — every section is skill-specific operational detail. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout: exact commands ("minutes search \"<name>\" --limit 10 --since <60-days-ago> --format json"), an MCP call signature, exact save paths and slug rules with worked examples ("María José Pérez → maria"), and a complete brief template with a good-vs-bad "Open with" example. Matches the 5 anchor; common cases are covered concretely. | 5 / 5 |
Workflow Clarity | Phases 0–5 are clearly sequenced with explicit validation checkpoints ("require exit status 0 before interpreting their output", "Any nonzero exit from a live-source command means the source is unavailable") and error-recovery paths (ordered calendar fallbacks, "If none return anything, ask once", silent exit in --auto mode, verify before claiming "first meeting on record"). Matches the 5 anchor with feedback loops and a gotcha checklist; no destructive or batch operations exist to trigger the cap. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), and the ~190-line body is a single self-contained file with clean phase headers and well-placed code blocks — good structure with minor organization gaps, matching the 4 anchor. It is not a 5 because there is no reference structure at all and some content (CLI stream contracts, detailed slug rules, the 15-bullet Gotchas list) could be split into a reference file; it is not a 3 because headers are clear and placement is appropriate for a speed-critical single-shot skill. | 4 / 5 |
Total | 17 / 20 Passed |