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 strong workflow sequencing and validation loops for risky image operations. Its weaknesses are an over-long, somewhat instructional Prompt Engineering section and references to bundle files that are not present on disk.
Suggestions
Tighten the Prompt Engineering section: trim the conceptual "why models work" prose and condense the adjective-substitution table to the most decision-relevant rows.
Either ship the referenced bundle files (reference/image/image-search.md, design-marker.md, reference/video/generation.md, follow-up.md, parameters-and-errors.md) or inline the essential content so no referenced path 404s.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete tool tables and executable code, but the lengthy "Prompt Engineering" section explains concepts and philosophy Claude largely already knows (e.g. why image models reason, extensive adjective-substitution tables), and could be tightened. Not the score-1 verbose concept primer, but above the lean anchor. | 2 / 3 |
Actionability | Provides fully executable tool.call / run_sdk_snippet code, concrete parameter tables, copy-paste retry and multi-view patterns, and an unambiguous tool-selection decision tree. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with validation checkpoints and feedback loops: the design-marker 4-step process, the failed-task retry loop via element_id, and the mandatory visual_understanding step before image-to-image generation. | 3 / 3 |
Progressive Disclosure | Content is well sectioned with one-level-deep, clearly signaled references (reference/image/image-search.md, reference/video/generation.md, etc.), but no references/ bundle directory actually exists, so the referenced paths are broken and navigation cannot be completed. | 2 / 3 |
Total | 10 / 12 Passed |