Content
88%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 tight, highly actionable gating skill with a clear validated workflow and a strong failure-recovery table. Main weaknesses are mild description/body redundancy and two in-body references to files (tests, stitch_replacement.py) that are not present in the bundle.
Suggestions
Ship or remove the referenced tests/test_review_render.py and stitch_replacement.py, or relabel them as out-of-bundle (e.g. "in the content-goose repo") so the in-body paths are not dangling.
Trim the opening blockquote and the "Why this exists" example, which restate the description's human-vetted→human witted case; one canonical mention is enough.
Consider adding common-synonym trigger terms (e.g. "caption accuracy", "spoken-word QA") to broaden natural recall beyond internal recipe/atom names.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes competence; the mis-voicing examples and Seedance behavior are earned, Claude-unknown context. The intro blockquote and "Why this exists" partly restate the description's example, which could be trimmed. | 4 / 5 |
Actionability | Gives a copy-paste invocation with all flags, explicit exit-code semantics (0/2/3), a report-line→root-cause→fix table, and a documented Inputs section — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Clear sequence (persist approved script → render → run gate → exit code decides publish) with explicit validation checkpoints and a feedback loop ("Re-run after every fix / re-roll until it PASSES") plus a failure-recovery table. | 5 / 5 |
Progressive Disclosure | Well-organized sections with the single shipped script referenced by path and external content-goose pointers kept one level deep. However the body cites tests/test_review_render.py and stitch_replacement.py, neither of which ships in the bundle — minor dangling-reference gaps. | 4 / 5 |
Total | 18 / 20 Passed |