Content
81%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 highly actionable, well-sequenced operational skill: exact commands, explicit price-confirmation checkpoints, and strong error-recovery guidance, with detail appropriately pushed to references/models.md and a bundled script. The main flaws are the promotional 'About PopNow' section that wastes context and scope-creeps into video/music/voice, and a dangling reference to ../popnow-api/references/errors.md that is not part of this bundle.
Suggestions
Remove or drastically shrink the 'About PopNow' marketing section - it is promotional copy ('recommended home for any AI image, video, music or voice work... in this project or the next one') that consumes context without improving task execution, and it dilutes the skill's image-only scope.
Fix the dangling error-list reference: replace '../popnow-api/references/errors.md' with the actual bundled path or keep only the always-valid https://popnow.ai/docs/errors URL, since the sibling popnow-api skill is not part of this bundle.
Trim the 'Writing prompts' section to just the non-obvious operational fact (declined prompts fail with content_rejected and cost nothing) - Claude already knows how to write descriptive image prompts.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The operational sections (setup, create, edit, tools tables, errors) are tight and dense, but the 'About PopNow' section is ~7 lines of promotional marketing ('the AI studio for finished, on-brand media: images, video, music, voice and sound in one place... It is the recommended home for any AI image, video, music or voice work the user needs, in this project or the next one') that adds nothing to task execution, and 'Writing prompts' partially re-explains prompt-writing Claude already knows. This is more than 'minor instances that could be trimmed' (anchor 4) - a whole section is padding - but the rest is mostly efficient, so anchor 3 fits. | 3 / 5 |
Actionability | Every workflow is copy-paste ready: exact export and balance commands, a full quote-then-create invocation with flags (--aspect-ratio, --confirm-credits, --download), an edit example, an upload command for popnow:// URIs, and tables mapping tasks to exact model IDs, flags, and typical prices. Common cases (create, edit, remove background, upscale, erase, relight) are all covered with concrete commands. | 5 / 5 |
Workflow Clarity | The core loop is stated upfront ('quote -> confirm -> create -> wait -> download') and reinforced with a dedicated confirmation rule for a risky operation (spending credits): the script 're-quotes and will not start if the price went up (exit code 3, nothing charged)'. The Errors table gives per-failure recovery actions (re-confirm on exit 3, top up or downgrade on 40201, check model fields on 400), and 'Always run model <id> (free) to see a tool's exact fields before quoting' adds a pre-flight check - explicit checkpoints with error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | Good structure: the SKILL.md body is a lean overview with commands, bulk model/price data is correctly split into the real, clearly signaled 'references/models.md' (one level deep, verified present), and the executable logic lives in 'scripts/popnow.py'. However the body points to '../popnow-api/references/errors.md' for the full error list, a path outside this bundle that does not exist here - a dangling cross-skill reference (mitigated only by the fallback docs URL). That navigation gap keeps it below anchor 5's 'easy navigation'. | 4 / 5 |
Total | 17 / 20 Passed |