Content
85%Weight 40%Scale 1-3Reviews 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 instruction skill with a clear sequenced workflow and explicit completion criteria. Its main weakness is token efficiency: the scope-guard and handoff statements are repeated across multiple sections rather than stated once.
Suggestions
Consolidate the handoff/scope-guard statements: state the content-amplifier, outreach-manager, and launch-registry boundaries once in the Scope guard section and reference them from later sections instead of restating them verbatim in Instructions steps 5–6, Reference Materials, and Next Best Skill.
The Reference Materials and Next Best Skill sections overlap heavily (content-amplifier and outreach-manager appear in both); merge or cross-reference to cut redundant tokens.
Verify the referenced bundle paths (scripts/connectors/hn.py, appstore.py, gdelt.py; references/ramp-benchmark.md) actually ship alongside SKILL.md, since none are present in this review fixture.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes Claude's competence (no concept explanations), but the handoff/scope-guard language for content-amplifier, outreach-manager, and launch-registry is restated nearly verbatim across Scope guard, Instructions steps 5–6, Reference Materials, and Next Best Skill, which could be consolidated. It is mostly efficient but has redundant padding, matching anchor 2 rather than the 'every token earns its place' anchor 3. | 2 / 3 |
Actionability | Despite being an instruction/spec skill with no code, the guidance is concrete and copy-ready: 'Duplicates are merged with votes transferred, never closed', 'all subscribers of the item minus the actor', 'never incentivized', 'one single follow-up, no more'. The scoring note explicitly does not penalize absence of code in instruction-only skills when guidance is this actionable. | 3 / 3 |
Workflow Clarity | An explicit 8-step numbered sequence (confirm launch → pull exports → cluster → spec loop → build shipped loop → spec harvest → route roadmap → metrics/snapshot) is paired with a 'Done when' completion checklist and SECURITY.md untrusted-input validation. This is a spec-delivery skill, not a destructive operation, so the destructive/batch feedback-loop cap does not apply; the Done-when checklist supplies the validation checkpoint anchor 3 requires. | 3 / 3 |
Progressive Disclosure | The SKILL.md is a concise overview with clearly signaled, one-level-deep references (ramp-benchmark.md, skill-contract.md, CONNECTORS.md, SECURITY.md, and sibling SKILL.md files) and well-organized sections; no inline wall of reference material and no nested 2+ level reference chains. No bundle directories are present in this fixture to verify the connector scripts, but the disclosure structure itself matches the anchor 3 overview-plus-one-level-deep pattern. | 3 / 3 |
Total | 11 / 12 Passed |