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 operational skill body: dense, executable, and install-specific, with a well-sequenced phase workflow, explicit validation and feedback loops, safety principles (read-only v1, show-before-write, credential masking), and a defined recovery point. The only structural weakness is that everything lives inline in SKILL.md with no reference files for the lookup-style material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries install-specific knowledge Claude cannot infer (handoff.json structure, user-ID formats per channel, exact helper names, service-label derivation); there is no generic concept explanation or padded prose, matching anchor 5's "every token earns its place" rather than anchor 4's trimmable over-explanation. | 5 / 5 |
Actionability | Fully executable guidance throughout: ready-to-run SQL queries, a complete idempotent TypeScript snippet with init/migrations/cleanup, concrete bash commands (git remote check, service restart via derived unit/label), exact file paths, and a when-to-use step table — copy-paste ready and covering the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Clear preflight gate, phased sequence (0–4) with explicit validation (smoke test via AskUserQuestion, "don't proceed to deeper work on a broken router", diagnose-and-re-test feedback loop, deferred-failure re-visit) and a "When done" checklist with a verify step; handoff.json is an explicit recovery point. Validation is present for the batch/destructive operations, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; sections are well-organized, and the one external delegation ("Run `/migrate-memory`") is clearly signaled at one level. But at ~220 lines with no reference files, lookup-style content (per-channel user-ID formats, the setup-steps table, access-policy options) is inlined — anchor 4's "good structure, minor organization gaps" fits better than anchor 5's appropriately-split content, and the under-50-line simple-skill exception does not apply. | 4 / 5 |
Total | 19 / 20 Passed |