Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a well-sequenced, validated workflow and concrete executable commands, but it is slightly over-padded with redundant defaults and inlines contract content that the referenced (but missing) bundle files should hold.
Suggestions
Provide the referenced bundle files (prompts/image_annotate.md, prompts/caption_rewrite.md, prompts/layout_review.md, and ../sn-image-base/SKILL.md) so the progressive-disclosure references resolve to real content.
De-duplicate parameter defaults: state them once in the Input Specification and reference them from the Workflow rather than repeating each default in both sections.
Move the large inline return-contract JSON and timing-schema notes into a dedicated reference file to reduce inline length and keep SKILL.md as an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence, but carries avoidable redundancy — parameter defaults are restated in both the Input Specification and the Workflow, and the timing/model placeholder notes are padded — pulling it below the lean top anchor. | 2 / 3 |
Actionability | Provides fully executable bash CLI invocations with concrete flags, explicit JSON return contracts, and copy-paste-ready commands for every pipeline step, matching the top anchor. | 3 / 3 |
Workflow Clarity | Sequences a clear Step 0–3 pipeline with explicit parsing/validation checkpoints, a defined error-handling strategy, and a generate→review→fix-hint retry loop, matching the anchor for clear sequence with validation and feedback loops. | 3 / 3 |
Progressive Disclosure | References are clearly signaled and one level deep, but the referenced files (prompts/image_annotate.md, prompts/caption_rewrite.md, prompts/layout_review.md, ../sn-image-base/SKILL.md, ../../docs/sn-image-generate_en.md) do not exist in the bundle, and substantial contract/spec content is inlined rather than split out. | 2 / 3 |
Total | 10 / 12 Passed |