Content
92%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 mature, highly actionable skill body: every step lands in concrete file writes with templates, validation is explicit (quality checklist plus the contract validator), and detail is properly pushed into three real reference files. The only cost is a little non-instructional prose — the narrative opener and maintainer-parity comments — and repeated restatements of the core asking rule.
Suggestions
Cut the 'A good agency would not hand them a twenty-field form' narrative opener down to one line; the rule section already carries the philosophy.
Move the maintainer copy/parity HTML comment out of the agent-facing body (or shrink it to one line) since it instructs maintainers, not the agent.
Consider consolidating the asking rule's restatements in Decision Rules or Quality Checks into references to the canonical 'The one rule' section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with harness-specific instruction and explains nothing Claude already knows, but contains minor trimmable material: the five-line agency narrative opener ("A good agency would not hand them a twenty-field form…"), maintainer-facing HTML comments about the shared block's copy/parity procedure, and the asking rule restated in "The one rule", Step 2, Decision Rules and Quality Checks. It is above the score-3 anchor (mostly efficient) but not every token instructs, so it falls short of the lean score-5 anchor. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: a fact-sheet table with a worked example row, literal output text for each file (e.g. "stage: intake, ids none/[], updated_by: ad-management-intake"), a copy-paste labelling table with exact strings like "(assumed from <source> — not confirmed)", a complete example assumptions message, and full sample decisions.md entries. This matches the score-5 anchor — concrete templates covering the common cases — rather than score 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | Steps 0–6 are explicitly sequenced (resume → gather → fact sheet → Section A → Section B → state assumptions → write and hand over), with a corrections sub-procedure, an end-of-run Quality Checks checklist (including "ads/ passes the contract validator"), and a Failure Modes table mapping symptom → cause → fix that serves as error-recovery feedback loops. The batch write operation is covered by validation checkpoints, matching the score-5 anchor and exceeding score 4's 'most checkpoints'. | 5 / 5 |
Progressive Disclosure | SKILL.md is a well-organized overview that routes to three real, one-level-deep bundle files — [references/gooseworks-adapter.md], [references/local-adapter.md] chosen by mode, and references/business-types.md for per-type detail (all verified present, 45–95 lines each) — with appropriately split content and a section explaining that paths are relative to the skill's own folder. The external meta-ad-manager contract is clearly located rather than nested, so navigation matches the score-5 anchor instead of the score-4 'minor organization gaps'. | 5 / 5 |
Total | 19 / 20 Passed |