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.
An exemplary router/orientation skill: dense with non-inferable project knowledge, well-structured navigation into verified one-level-deep references, and no filler. The only refinement space is sequencing the everyday commands into an explicit change→validate workflow and possibly inlining one minimal mutation example.
Suggestions
Add a short ordered workflow (e.g. edit → make format → make typecheck-python → uv run pytest path/to/test) so validation commands become explicit checkpoints rather than an unordered list.
Consider inlining a minimal skeleton of one mutation (or pointing to it by section name the way the Hard Rules do) so the most common task has a concrete starting template without opening a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries project-specific knowledge Claude could not infer (memoized startup shortcuts, import side effects, daemon-test patterns, naming conventions) with zero padding or explanation of known concepts. Commands are given bare with inline comments only where they add facts. Matches the "lean and efficient; every token earns its place" anchor. | 5 / 5 |
Actionability | Copy-paste-ready commands ("make dev-backend", "uv run pytest path/to/test -n auto", "make graphql") and concrete before/after naming examples ("createThing, patchThing, setThing, deleteThing — not applyThingChanges"). Not a 5 because the body itself contains no code template; the templates are delegated to the reference files, so a reader must hop to a reference for the common case of writing a mutation. | 4 / 5 |
Workflow Clarity | The "What Are You Doing?" routing table gives an unambiguous task→reference decision sequence, and validation commands (tests, make typecheck-python, make format) are listed up front. Not a 5 because the body never sequences these into an explicit step order or feedback loop (e.g. change → format → typecheck → test), though as a router skill its real workflows live in the well-structured references. | 4 / 5 |
Progressive Disclosure | A clear overview with a task→reference table pointing one level deep to four real files (graphql-patterns.md, test-patterns.md, llm-trace-tests.md, database-patterns.md), each existing in the bundle with the cited section headers verified present ("Query vs Mutation", "Naming: use the HTTP verb", "Waiting on Daemons", "Startup Shortcuts"). Inlined content is appropriately the hard rules and orientation; details correctly live in references. | 5 / 5 |
Total | 18 / 20 Passed |