Content
100%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 content is an exemplary instruction-only skill: a tightly sequenced six-step workflow with explicit validation checkpoints, approval gates, feedback loops, and copy-paste commands, delegating all reference detail to well-signaled repo files. It is lean, assumes Claude's competence, and adds only project-specific knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, project-specific decision rules with zero padding — "Swagger 2.0 fails", "Standalone SSE and stdio servers fail", "Do not use `npm test -- recipes.server`. It also runs the Storybook tests, which match no file and exit 1" — and it assumes competence, never explaining OpenAPI, MCP, YAML or testing basics. Every token earns its place, matching anchor 5 rather than 4, which would require instances of over-explanation to trim. | 5 / 5 |
Actionability | Fully actionable throughout: copy-paste commands (`npm ci --prefix apps/reef`, `npx vitest run --project server recipes.server`, `npm run check --prefix apps/reef`), an exact id pattern (`[a-z][a-z0-9_]*`), an exact schema header line, precise source checks ("Confirm a 200 with no redirect, and an `openapi` field of `3.0.x` or `3.1.x`"), and exact live-test steps with a concrete URL. As an instruction-only skill with concrete, specific guidance, it meets anchor 5; there are no pseudocode stand-ins or missing key details that would drop it to 4. | 5 / 5 |
Workflow Clarity | Six clearly sequenced sections with explicit checkpoints — "Done when you hold at least one usable source URL", an approval gate ("Show the user a short plan and wait for their approval"), a test-fix feedback loop ("Run, and fix until both pass"), and direct per-source verification steps. This matches anchor 5 (explicit validation, feedback loops); the recipe-writing task is not destructive or batch, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a workflow overview that delegates all format and design detail to clearly signaled, one-level-deep references: `GLOSSARY.md` (the Provider Recipe entry), ADRs 0002-0004, `apps/reef/recipes/schema.json` ("Its `description` fields are the field docs"), and example recipes (`linear`, `github`, `sentry`) each annotated with what it demonstrates. No bundle files exist to inline, the references are not nested, and reusing existing repo docs instead of duplicating them matches anchor 5's well-signaled, easy-to-navigate structure. | 5 / 5 |
Total | 20 / 20 Passed |