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.
The body is an exemplary terse procedural skill: dense, repo-specific knowledge delivered as imperative rules with concrete commands, examples, stop conditions, and validation loops at every stage. Its only structural refinement would be splitting the authentication and icon rule blocks into a bundled reference to slim the main file further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and declarative throughout ("Swagger 2.0 fails.", "Standalone SSE and stdio servers fail.", "Done when you hold at least one usable source URL"), with no explanation of concepts Claude already knows and every sentence carrying non-obvious domain rules. It matches the level-5 anchor 'lean and efficient; assumes Claude's competence; every token earns its place'. | 5 / 5 |
Actionability | Guidance is copy-paste executable: exact commands ("npx vitest run --project server recipes.server", "npm run check --prefix apps/reef", "./dev run"), exact file paths, a URL pattern for live testing, and a warning against a broken command ("Do not use `npm test -- recipes.server`"). Concrete examples (linear, github, sentry, hubspot, attio) anchor each decision rule, matching the level-5 anchor for fully executable, ready guidance. | 5 / 5 |
Workflow Clarity | Six clearly sequenced numbered sections with explicit checkpoints and feedback loops: a stop-and-ask gate for existing ids, 'Done when' criteria in sections 2 and 4, a plan-then-wait-for-approval gate before writing, and 'Run, and fix until both pass' plus direct source verification (fetch the URL, POST an initialize request). This matches the level-5 anchor of clear sequencing with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The skill ships no bundle files and keeps the body well-sectioned, pushing detail to one-level-deep repo artifacts clearly signaled up front (GLOSSARY.md, ADRs, schema.json, example recipes, docs/development.md). It falls short of level 5 because sizable decision-rule blocks (the seven authentication rules and the icon/light-dark variant guidance) are fully inlined and could live in a small reference file, and there are no bundled references of its own. | 4 / 5 |
Total | 19 / 20 Passed |