Content
85%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-validated two-mode workflow with excellent progressive disclosure into a verified reference bundle. The one real weakness is redundancy: the rights/never-estimate policy is repeated across seven sections, inflating token cost without adding guidance.
Suggestions
State the evidence-gating rule (never estimate missing organic/Hook/Message/Quality/CTA evidence → NOT_SCORED/NEEDS_INPUT) once in Decision Gates or the Skill Contract, and have other sections reference it instead of restating it — the Output expectation, Data Sources, paid Step 2, Handoff Summary, and Example each repeat it nearly verbatim.
Consolidate the rights-status blocking rule (expired/revoked/disputed/unknown fails closed) into a single rights-verification section; it currently appears in the Scope guard, both Done-when lists, paid Step 7, repurpose Step 7, and both Decision Gates.
Trim cross-skill boundary prose (the momentum-planner/social-calendar-builder/social-creative-builder split is explained twice, in the Scope guard and again by reference in Reference Materials) to a single handoff note.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core never-estimate / rights-gating policy ("Missing … Hook/Message/Quality/CTA evidence is never Estimated; it makes that asset NOT_SCORED/NEEDS_INPUT") is restated nearly verbatim in the Output expectation, Skill Contract, Data Sources, paid Step 2, Decision Gates, the Example, and the Handoff Summary. The body assumes Claude's competence and explains no known concepts, but the repeated policy restatements across seven sections are more than the minor trimming of the 4 anchor — it genuinely needs consolidation into one stated rule. | 3 / 5 |
Actionability | Both modes get numbered step sequences each bound to a named fill-in template, a concrete selection scheme (five 1–5 observations gating a /25 score), an exact library naming convention ("[campaign]_[creator_ref]_[platform]_[type]_[variation]_[date]"), explicit machine-readable statuses, and a worked example table covering the most common failure case. This is fully executable guidance for an instruction-only skill. | 5 / 5 |
Workflow Clarity | Mode selection has keyword routing with a conflict rule ("run repurpose first to produce the assets, then hand to paid — do not silently merge"), steps are clearly sequenced, and validation is pervasive: evidence-completeness gating before any score/spend, "Done when" checklists per mode, Stop-and-ask / Continue-silently decision gates, rights verification before activation, and termination/visited-set rules. | 5 / 5 |
Progressive Disclosure | The body is an overview that delegates each step's detail to verified one-level-deep references — references/templates.md (646 lines, headings match every anchor link cited in the body) and references/atom-extraction.md — plus clearly signaled family references (skill-contract.md, state-model.md, CONNECTORS.md, per-platform specs). Structure and navigation are easy to follow. | 5 / 5 |
Total | 18 / 20 Passed |