Content
92%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 process skill: lean, well-sequenced RED-GREEN workflow with explicit validation gates, and clean one-level-deep disclosure into a real test-matrix reference. The only gap is the absence of copy-paste-ready commands, which is largely mitigated by delegation to the repo's AGENTS.md contracts.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body is lean with zero filler: every section (design note, RED, API validation, implementation, GREEN/verify, handoff) carries only actionable directives like "Return usage errors with exit code `2`" and "Build a binary at a worktree-specific path". It assumes Claude's competence and explains nothing it already knows. | 5 / 5 |
Actionability | Guidance is concrete and specific ("Search `docs/openapi/paths.txt`, then inspect the exact operation in `docs/openapi/latest.json`", exit code `2`, worktree-specific binary path), but there are no copy-paste-ready commands (e.g., actual test/build invocations) — much execution detail is delegated to `AGENTS.md` and the test-matrix reference. That places it at the 4 anchor (mostly executable, minor gaps) rather than 5. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced (design note → establish RED → validate API support → implement narrowly → reach GREEN and verify → hand off) with explicit validation checkpoints and feedback loops: "record the expected failure before implementation", "Rerun the focused failing test after each small fix", "Run adjacent package and command tests", and the pre-handoff branch-head comparison. This matches the 5 anchor's validate-fix-retry pattern. | 5 / 5 |
Progressive Disclosure | The SKILL.md body is a concise overview with a single well-signaled, one-level-deep bundle reference — "Read [references/test-matrix.md](references/test-matrix.md) for applicable CLI, output, artifact, and auth cases" — and the referenced file exists with the promised content. Detailed test-case material is appropriately split out; navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |