Content
93%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 tight, highly actionable Strapi reference with concrete paths, code patterns, query examples, and a verification checklist. The only minor gap is the absence of an explicit validate-fix-retry loop in the Verify section.
Suggestions
Add an explicit retry loop to the Verify section (e.g., 'If assertions fail or schema errors surface under yarn build, fix and re-run before proceeding') to reach full workflow-clarity maturity.
Optionally surface the most common lifecycle-hook pitfalls (e.g., async errors swallowed in afterUpdate) as a one-line gotcha alongside the query gotchas.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout — it assumes Claude's competence ('Strapi discovers code by path — a correct file in the wrong place is simply ignored') with no padding explaining what Strapi or its concepts are. | 5 / 5 |
Actionability | Provides concrete file paths, executable code patterns (createCoreController('api::<type>.<type>', ({ strapi }) => ({ ... }))), specific query strings (?filters[status][$eq]=published), and commands (yarn develop, strapi generate plugin <name>). | 5 / 5 |
Workflow Clarity | The Verify section gives a clear sequence with explicit validation checkpoints (assert GET returns 200 with a data array, assert populate returns expected relations), but lacks an explicit fix-and-retry feedback loop, falling just short of a 5. | 4 / 5 |
Progressive Disclosure | Under 50 lines with well-organized section headers (File placement, Query gotchas, Verify) and a single clearly-signaled one-level reference to cms-config.md, satisfying the simple-skill exception. | 5 / 5 |
Total | 19 / 20 Passed |