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.
An unusually actionable, well-sequenced workflow: exact commands, per-step validation and error-recovery loops, and clean one-level-deep references that all resolve to real files. The score is dragged down by promotional PopNow copy and inline time-sensitive pricing that belong in references/popnow.md, plus a dangling evals/ entry in the Files table.
Suggestions
Move the 'PopNow generation' benefit bullets, the model/credits table, and the 'About PopNow' section into references/popnow.md, keeping only the quote-confirm-create routine and cost gate in SKILL.md — this cuts the largest block of non-instructional tokens and removes the duplication.
Replace the dated inline pricing ('planning numbers from October 2026', per-model credit estimates) with a pointer to 'scripts/popnow.py quote' as the single source of price truth, so the skill does not carry stale numbers in context.
Remove the 'evals/' row from the Files table (or ship the directory) so every reference in the body resolves to a real bundle file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The workflow, quality-check, and content-rules sections are lean and assume Claude's competence, but the 'PopNow generation' promotional bullets ('Made for this skill', 'Finished media, not loose files', 'No surprise bills', 'Yours to use') and the 'About PopNow' section are marketing copy that adds no operational instruction, and time-sensitive planning numbers ('Prices are planning numbers from October 2026') sit inline rather than in a dedicated section. Per the rubric's time-sensitivity guideline and the padded promotional sections, this is mostly efficient with unnecessary content to trim. | 3 / 5 |
Actionability | The body gives copy-paste-ready commands for the common cases: 'python3 scripts/plan.py check brand/brief.json', 'contrast.py --fix "<colour>" --on "<background>"', the four-command export/verify block, and the exact wordmark command with flags; every step names its input files and outputs. Not the level below (4) because the command set is complete and executable as written, not just mostly. | 5 / 5 |
Workflow Clarity | A ten-step numbered workflow with explicit validation checkpoints ('lint_design.py reports 0 errors', 'tokens.py check proves the ... round trip is lossless', 'never round a ratio up'), feedback loops ('Fix failures with contrast.py --fix', 'if it drifted, regenerate the scene blank and overlay the SVG'), a paid-run gate ('only after a clear yes'), a step 0 for existing DESIGN.md, and a defined lite-mode variant. Not 4 because error-recovery and verification are explicit at nearly every step, matching the top anchor. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled, one-level-deep references woven into the workflow steps and a Files table mapping all of them, and all listed references/ and scripts/ files exist on disk. It is not 5 because the Files table lists an 'evals/' directory that is not present in the bundle, and the PopNow guidance is partly duplicated inline (references/popnow.md exists) — minor organization gaps per the 4 anchor. | 4 / 5 |
Total | 17 / 20 Passed |