Content
80%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, highly actionable skill body with excellent progressive disclosure and concrete examples. Its weakest area is workflow clarity for batch generation, which lacks an explicit verify→fix→retry checkpoint, and some redundancy inflates length.
Suggestions
Add an explicit output-verification checkpoint for batch runs (e.g., confirm each output image file exists and is non-empty before counting it as a success) so the batch flow has a clear validate→fix→retry loop and can score above the batch cap.
De-duplicate the identity-preservation guidance, which appears in both 'Identity-preserving reference prompts' and 'Reference-Image Identity Preservation' — consolidate into one section to tighten the body.
Add a short numbered end-to-end workflow (Step 0 prefs → provider/model resolution → generate → verify output) so the sequence and checkpoints are explicit in one place rather than implied across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient tables and concrete commands with no beginner-concept padding, but the identity-preservation guidance is duplicated across two sections and the env-var table is lengthy — minor trimming available. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready CLI examples cover the common cases (basic, aspect ratio, prompt files, reference image, specific provider, batch), backed by complete options and env-var tables. | 5 / 5 |
Workflow Clarity | A clear sequence exists (blocking Step 0 prefs → provider/model resolution → generate) with retry-based error handling, but batch operations lack an explicit output-verification checkpoint; per the batch cap this stays at 3. | 3 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with well-signaled, one-level-deep references (providers/*.md, config/*.md, usage-examples.md) all confirmed to exist, and detailed material is appropriately split into those files. | 5 / 5 |
Total | 17 / 20 Passed |