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 well-structured, highly actionable body: sequenced steps with evidence gates and copy-paste connector commands, backed by a real one-level-deep templates file whose anchors all resolve. Minor deductions for repeated evidence-policy statements and for reference links that do not resolve within the provided bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and skill-specific with no re-teaching of concepts Claude already knows, and includes concrete commands rather than padding. It is not level 5 because the dated-evidence/NEEDS_INPUT rule is repeated roughly four times (Skill Contract, Data Sources, Instructions steps 2 and 5, Worked Example) and the 60-word "Promotes" bullet could be trimmed. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste commands with arguments (gdelt.py '"<competitor>"' --days 30, youtube.py channel <partner-handle>, the keyless YouTube RSS URL into rss_monitor.py), eight steps each anchored to a fill-in template in references/templates.md, and a worked example showing the exact expected output. It is not level 4 because no step relies on vague direction — every step names its output artifact or command. | 5 / 5 |
Workflow Clarity | The eight steps are clearly sequenced with explicit validation gates (step 2's dated-evidence requirement, step 5's declared-formula requirement), a NEEDS_INPUT-with-collection-plan feedback loop, and a three-item done-when checklist. This matches the top anchor's 'explicit validation steps; feedback loops; checklists' better than level 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview with one-level-deep, clearly signaled references — references/templates.md exists and every anchor link in the Instructions section resolves to a real header. It is not level 5 because most links in Reference Materials point outside the provided bundle (../../../references/skill-contract.md, ../../../CONNECTORS.md, sibling scout/campaign-planner skills) and the connector scripts under ${CLAUDE_PLUGIN_ROOT}/scripts/ are not included, so navigation is incomplete as bundled. | 4 / 5 |
Total | 18 / 20 Passed |