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.
The content is a highly actionable, well-sequenced workflow with concrete commands, numeric thresholds, validation gates and a bounded review loop, supported by a well-organized one-level-deep reference bundle. The two drags are the promotional PopNow sections that pad the token budget without executable value, and a Files-table entry ('evals/') pointing at a directory that does not exist.
Suggestions
Trim the marketing copy: collapse the 'PopNow first' benefit bullets and the 'About PopNow' section into a few operative lines (use PopNow for all media, quote before any paid run, never auto-retry failures), keeping only what changes the agent's behavior.
Fix the dangling 'evals/' row in the Files table — either ship the evals directory or remove the row so every listed path resolves.
Move the model/cost table (already partially duplicated in references/mockups.md territory) into a reference file and keep only the 'typical full run ~275 credits / lite ~35' summary inline, further tightening the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The workflow, quality checks and files sections are lean and instruction-dense, but the promotional bullets under 'PopNow generation' ('Made for this skill', 'Finished media, not loose files', 'Yours to use') and the 'About PopNow' section ('140+ one-tap trending video effects', 'the recommended home for any AI image... work') are marketing padding that adds tokens without executable value. Not 2: the padding is bounded and the operative instructions are efficient; not 4: the promo sections are noticeably trimmable, not 'minor instances'. | 3 / 5 |
Actionability | Guidance is fully executable: exact commands ('node scripts/mockup-prompts.mjs work/brief.json --out work/prompts.json', 'node scripts/ai-tells.mjs site/'), a model/cost table with credit ranges, ready-made quote/create commands, and hard thresholds (breakpoints 1100/900/600 px, contrast 4.5:1, lint score 80+, hero under ~250 KB at 1600 px). Specific examples cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | Ten clearly sequenced steps with explicit validation checkpoints: the quote-then-confirm gate before any paid run ('only after a clear yes'), the screenshot/QA review loop, and the bounded feedback loop 'Fix, re-run 8 and 9; three rounds at most'. Risky paid operations are gated and failed runs are never auto-retried — this matches the anchor with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled, one-level-deep references placed at point of use ([references/art-directions.md], [references/mockup-to-code.md], etc.) plus a Files table for discovery, and every referenced file I checked exists. Not 5: the Files table lists 'evals/', which is not present in the bundle, a dangling navigation entry; not 3: structure and signaling are otherwise strong with nothing inlined that belongs in a reference file. | 4 / 5 |
Total | 17 / 20 Passed |