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 well-engineered instruction skill: the body stays an operational overview while templates, taxonomy, and a worked example live in clearly signaled reference files, and the workflow carries explicit evidence-labeling, freshness, and completeness gates. The 8-step sequence plus exact difficulty weights and keyless connector commands make it directly executable. Only conciseness dips slightly below the top due to duplicated labeling mandates and one over-dense contract sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Operational throughout with no explanations of concepts Claude already knows, but a few spots could be trimmed: the evidence-labeling mandate is stated twice ("Label every metric Measured, User-provided..." plus the "Quality bar" paragraph) and the "Done when" clause packs six hyphen-bound qualifiers into one sentence. Not 5 because of these redundancies; not 3 because there is no real padding or filler. | 4 / 5 |
Actionability | Provides copy-paste-ready commands with flags and caveats ("python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py\" search \"<keyword>\" --limit 10" with --scrape/--country/--tbs, and the tavily --answer corroboration path), an exact weighted difficulty formula (Top-10 authority 25%, page authority 20%, content quality 20%, backlinks 20%, SERP stability 15%), and a concrete outlier threshold (">=2x the channel average"). Not 4: the common cases are covered end-to-end with executable commands, output templates, and a worked example reference. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced steps (bind query → map composition → analyze pages → patterns → features → intent → difficulty → recommendations) with explicit validation and feedback loops: missing inputs become "Unknown with its gap reason and prevents a partial True Difficulty score", stale observations become "NEEDS_REFRESH, not current evidence", and a "Done when" checklist plus "Quality bar" gate completion. Not 4: checkpoints are explicit and global, with error-recovery paths rather than implicit validation. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview that delegates bulk detail to three real, verified, one-level-deep bundle files (references/analysis-templates.md, references/example-report.md, references/serp-feature-taxonomy.md), each clearly signaled inline ("See [Analysis Templates](references/analysis-templates.md) for the compact templates") and again with annotations in the Reference Materials list. Not 4: content is appropriately split, navigation is easy, and no reference file chains to another. | 5 / 5 |
Total | 19 / 20 Passed |