Content
78%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-structured skill body: concise sections, a concrete sequenced workflow with a user-choice checkpoint, and exemplary progressive disclosure that keeps the bulky template index in a single one-level-deep reference. The main gaps are the absence of a worked final-prompt example and a Maintenance section that is tangential to skill invocation.
Suggestions
Add one short worked example of a finished GPT-Image2 prompt (the six blocks filled in) next to the existing example image, so actionability reaches copy-paste-ready without adding a reference file.
Trim or relocate the Maintenance section ('npm run generate:style-skill', 'npm run install:skill') to the source repository's README, since it is irrelevant to invoking the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no concept explanations, no padding in the Workflow or Output Defaults sections). Minor over-inclusion keeps it below 5: 'The reference is generated from data/style-library.json' and the Maintenance section's npm install commands are repository-maintenance context rather than invocation guidance. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: a fixed match order ("template category, visual style tag, scene tag, then nearest example cases"), six named prompt blocks, language-specific output defaults, and runnable commands. It falls short of fully copy-paste-ready (5) because no worked text example of a finished GPT-Image2 prompt is shown — the only example is an image plus a one-line request. | 4 / 5 |
Workflow Clarity | The six-step Workflow is clearly sequenced with an explicit decision checkpoint at step 4 ("If several are plausible, present 2-3 options with short reasons and ask the user to choose"). It is not a destructive or batch operation, so no validation cap applies; it misses 5 only because there is no step verifying the built prompt against the reference's pitfalls before output. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a clear 53-line overview with one well-signaled, one-level-deep reference ("Read references/style-library.md before choosing a template or style") that actually exists and holds the 659-line template index, plus a verified asset image (assets/city-life-system-map.png). Content is appropriately split and navigation is easy, matching the top anchor. | 5 / 5 |
Total | 17 / 20 Passed |