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.
An exemplary instruction-style skill body: concrete executable commands, an explicit scoring model, sequenced phases with a done-when checklist, and a clean one-level reference bundle that keeps the overview lean. The only improvement space is trimming a few provenance/justification asides.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious domain specifics (the Opportunity formula, the GSC API's lack of a position filter, funnel-stage patterns) rather than concepts Claude already knows; only minor padding exists, such as the provenance parenthetical "(Impact×Confidence + funnel-stage scoring adapted from an external SEO-ops competitive analysis)" — anchor 4, not 5, since a few lines could be trimmed. | 4 / 5 |
Actionability | Copy-paste-ready commands with arguments (suggest.py --expand, firecrawl.py search --limit 10, pageviews.py --months 12), an exact scoring formula with intent-value constants (1/1/2/3), enumerated evidence labels, an exact save path, and a concrete rewrite rule ("Rewrite generic advice into a concrete keyword + volume + difficulty + reason") fully cover the common cases per anchor 5. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced phases announced as [Phase X/8], an explicit 'Done when' checklist (every keyword carries volume + difficulty + intent with source ref and evidence label), plus Unknown/NOT_SCORED handling rules provide explicit validation checkpoints; this is read-only research, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | A ~95-line overview with full templates, expansion patterns, and worked examples correctly split into five real one-level-deep reference files (verified present in the bundle), each clearly signaled with a one-line description in the Reference Materials section — clear navigation with only a single sibling cross-link. | 5 / 5 |
Total | 19 / 20 Passed |