Content
71%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.
The body is highly actionable, with executable commands for every mode and thorough error handling, but it is over-long: duplicated configuration instructions, general prompt-writing guidance, and usage galleries inflate the token budget. Most of that overflow belongs in one-level-deep reference files that don't exist.
Suggestions
Deduplicate API key setup: keep one canonical configuration section and remove the repeated export instructions from the quick-start path.
Move '提示词最佳实践', '常见使用场景', and the error catalog into a references/ file (e.g., references/prompting.md, references/errors.md) and link them from SKILL.md to cut the ~440-line body down to an operational overview.
Trim '轮询和超时控制' and '高级选项' to the parameter table plus one example, since --poll-interval/--timeout defaults are already documented in the parameter table.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational but contains redundant and padded sections: API key setup is explained twice (the quick-start export block and the '如何配置 API Key' section), '轮询和超时控制' shows three examples differing only in numbers, and '常见使用场景' and '提示词最佳实践' repeat general prompting knowledge Claude already has. Not a 2 because the bulk is genuinely task-specific operational detail. | 3 / 5 |
Actionability | Every generation mode ships a copy-paste-ready bash invocation of scripts/generate-image.sh with concrete flags, backed by a full parameter table with defaults, a status table, and an error catalog with cause-and-solution pairs. The referenced scripts (generate-image.sh, generate_image.js) exist in the bundle. | 5 / 5 |
Workflow Clarity | The three-step synchronous workflow (submit, wait, download) is clearly stated, and the error section provides recovery guidance (retry after 429, raise --timeout). It falls short of 5 because checkpoints are catalog-style rather than an explicit validate-then-proceed loop, and there is no post-download verification step. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and the script bundle is correctly referenced, but ~440 lines are entirely inlined in SKILL.md. Content that clearly belongs in reference files — prompt best practices, usage scenarios, the error catalog, and the model comparison — has no references/ directory to be split into. Good structure, but heavy content that should be separate is inline. | 3 / 5 |
Total | 15 / 20 Passed |