Content
56%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 well-organized with concrete usage commands, clear requirements, and a good trigger section. However, it references a script (scripts/generate_image.py) that is missing from the bundle entirely, omits key operational details like valid --size values, and carries mild redundancy (How It Works, Examples) plus a version-sensitive preview model ID.
Suggestions
Ship the referenced scripts/generate_image.py in the bundle (or remove the reference), since the entire skill currently hinges on a file that does not exist.
Document valid --size values (e.g., 1K/2K/4K) and add a brief post-run check (verify the PNG exists and is non-trivial) to the workflow.
Trim the redundant 'How It Works' and 'Examples' sections and move or isolate the version-specific model ID (gemini-3-pro-image-preview) so it can be updated without touching the core instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but includes unnecessary sections that could be tightened: 'How It Works' restates what the Usage command already shows, and the three 'Examples' dialogue blocks largely repeat the 'When to Use This Skill' triggers. Additionally, the version-specific preview model ID ('gemini-3-pro-image-preview') is time-sensitive information not placed in a deprecated/old-patterns section, which the guidelines say should penalize conciseness. | 3 / 5 |
Actionability | The Usage section gives concrete, copy-paste-shaped bash commands, but key details are missing and execution is broken in practice: valid --size values are never enumerated, and the referenced 'scripts/generate_image.py' does not exist in the bundle (no scripts/ directory at all), so the commands as written cannot run. This lands on anchor 3 ('Some concrete guidance but incomplete... missing key details') rather than 4. | 3 / 5 |
Workflow Clarity | This is a simple single-task skill and the single action is nearly unambiguous: run the script with a prompt, optional output path, and optional --size, with requirements (GEMINI_API_KEY) and output contract stated. It falls short of the simple-skill 5 because there is no post-run verification guidance (e.g., confirm the file exists before using it) and the workflow depends on a script absent from the bundle. | 4 / 5 |
Progressive Disclosure | The body itself is organized into clear sections, but scored against the actual bundle structure (file listing shows only SKILL.md — no references/, scripts/, or assets/ exist), the sole referenced path 'scripts/generate_image.py' is dangling, so the disclosure structure does not hold together. This matches anchor 3 ('Some structure but could be better organized; references present but not clearly signaled') — not a 2, since the in-document structure is genuinely well organized and only one reference is broken. | 3 / 5 |
Total | 13 / 20 Passed |