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.
A tight, well-organized skill body that earns its tokens with load-bearing paths, query gotchas, and concrete verify assertions. The main weaknesses are placeholder-only code in a couple of sections and a Verify sentence missing its leading verb, plus the absence of an explicit fix-and-retry feedback loop.
Suggestions
Fix the Verify sentence start — add a leading verb (e.g., 'Run the `develop` script, confirm the type appears in admin...') so the step is unambiguous.
Add a short validate→fix→retry loop in Verify (e.g., 'If `build` reports schema errors, fix and re-run before creating entries') to reach a full feedback loop for schema changes.
Provide a minimal executable lifecycles or services snippet instead of describing them as 'all business logic', or point to a one-level-deep reference file for the full pattern.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it states the load-bearing fact 'Strapi discovers code by path' and gives terse paths, query strings, and verify assertions with no padding or explanation of basics, matching the score-5 anchor. | 5 / 5 |
Actionability | Concrete code (the createCoreController wrapper) and real query strings are provided, but paths use `<type>` placeholders requiring substitution, services/lifecycles are described rather than shown, and the Verify sentence is malformed at its start, so it sits at 4 with minor gaps rather than fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | The Verify section sequences run develop → confirm in admin → create entry → assert GET 200 with data array → assert populate returns relations, with explicit validation assertions and a build-script error-surfacing note, but no explicit validate→fix→retry feedback loop, so it fits anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | A short, well-sectioned overview (File placement, Query gotchas, Verify) that offloads project config and deployment detail to a clearly signaled one-level-deep reference [cms-config.md](../../.opencastle/stack/cms-config.md), keeping API patterns inline — matching the score-5 anchor for a sub-50-line skill. | 5 / 5 |
Total | 18 / 20 Passed |