Content
73%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 body is a well-sequenced, checklist-driven preflight with strong validation gates and clear sibling routing. Its main weakness is conciseness — repeated boundary/routing statements and ROAS-framework filler inflate the token budget without adding actionable value.
Suggestions
State the 'checks only — does not rewrite or score' boundary once (e.g. in the Skill Contract) and reference it rather than restating it in the intro, Instructions close, and Next Best Skill.
Trim framework-narration filler such as 'This works the ROAS O (Offer) lever from the post-click side...' down to the one-phrase role it plays, since the sibling-skill links already convey the rest.
Consolidate the handoff/contract routing rules (hot-cache, open-loops, owner routing) into a single handoff subsection instead of scattering them across Skill Contract, Instructions step 8, and Next Best Skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but padded: the 'checks only / does not rewrite' boundary and the routing to landing-optimizer / ad-account-auditor are restated across the intro, Instructions close, and Next Best Skill, and framework filler like 'This works the ROAS O (Offer) lever from the post-click side...' could be trimmed. | 3 / 5 |
Actionability | Provides one copy-paste command ('python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py" scrape <landing-url> --mobile') and concrete per-check criteria (count required fields, mark Pass/Partial/Fix, label Measured/Estimated), with only minor gaps in executable coverage. | 4 / 5 |
Workflow Clarity | An explicit 8-step numbered sequence is backed by a 'Quality bar before handoff' checklist, a 'Done when' gate, Measured/Estimated labeling discipline, and a re-preflight loop ('return here to re-preflight after the fix') — matching the checklist-with-feedback-loop anchor. | 5 / 5 |
Progressive Disclosure | Clear section structure with one-level-deep, well-signaled references (skill-contract.md, CONNECTORS.md, SECURITY.md, roas-benchmark.md, firecrawl.py); no bundle files ship alongside the skill, and some contract/handoff detail is inlined rather than split out, keeping it just below the score-5 anchor. | 4 / 5 |
Total | 16 / 20 Passed |