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.
A well-engineered instruction skill: a clearly sequenced workflow with genuine validation gates and feedback loops, concrete executable commands with justified parameterization, and clean one-level-deep reference files verified to hold the promised content. The only slack is rhetorical repetition of the no-change philosophy, which keeps conciseness a notch below the top.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and skill-specific — it never explains concepts Claude already knows (no 'what a PR is', no library tutorials), and every rule is non-generic judgment. However, the no-change philosophy is argued rhetorically in at least three places ("The default answer is no change", the ladder's cost column, "a green suite bought that way costs more than a red one"), so a few passages could be trimmed without losing guidance. Efficient with minor instances of over-explanation — level 4, not the 'could be tightened' level 3. | 4 / 5 |
Actionability | Commands are copy-paste ready: the suite-discovery grep/git block, the merge-base diff sequence with `-M`, and the lint/validate invocations with env vars and flags. Placeholders (`<the spec you edited>`, `$CEKURA_AGENT_ID`) are explicitly justified parameterization ("# whatever this repository calls it"), not pseudocode. The decision-table headers and the six-rung edit ladder give concrete, executable structure for the common cases. | 5 / 5 |
Workflow Clarity | Steps 0–8 are clearly sequenced with explicit validation checkpoints and feedback loops: stop conditions in step 0 ("If the base or HEAD will not resolve, stop and say so"), "Lint, then validate — never live" with "An edited spec that has not returned `valid: true` is not finished", post-extend re-reading of pre-existing statements, fork-PR degradation, and the step-8 checklist (keys unchanged, nothing newly blocked, diff re-checked against the changed-file list). This matches the top anchor including checklists and error recovery. | 5 / 5 |
Progressive Disclosure | The body is a workflow overview; all detail is split into three real, one-level-deep reference files, each clearly signaled with what it contains ("references/change-triage.md carries the per-layer table", "references/edit-modes.md has before/after JSON for each one, plus the compatibility checklist", "references/pr-automation.md carries the CI wiring") — all verified to exist and to contain exactly what is claimed. Navigation is easy and nothing that belongs in a reference is inlined. | 5 / 5 |
Total | 19 / 20 Passed |