Content
73%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 strong instruction-style skill body: the eight-step preflight workflow is clearly sequenced with explicit validation (quality bar), a stop-and-ask path when inputs are missing, and honest Measured/Estimated metric labeling. The main weakness is token redundancy — the check-vs-repair boundary and sibling routing are repeated across three sections — and references that all point outside the bundle, which limits verifiability.
Suggestions
State the scope boundary (checks only; page repair → landing-optimizer; RQS/vetoes → ad-account-auditor) once — in the intro or Skill Contract — and delete the restatements in the Instructions closing paragraph and Next Best Skill, which repeats the same routing already given in step 8.
Trim the opening paragraph, which restates the frontmatter description nearly verbatim; a one-line purpose statement plus the Quick Start examples carries the same information.
Consolidate the per-Fix routing (landing-optimizer, offer-claims-registry, ad-account-auditor, NEEDS_INPUT) scattered across Instructions, the closing paragraph, and Next Best Skill into a single routing list or table in one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with no explanations of concepts Claude already knows, but the scope boundary ("checks only"; repair → `landing-optimizer`; RQS → `ad-account-auditor`) is restated three times — intro paragraph, the Instructions closing paragraph, and Next Best Skill — and the intro duplicates the frontmatter description nearly verbatim. Fits anchor 3 ("could be tightened"); not 4 because the repetition is recurring across sections, not a minor instance. | 3 / 5 |
Actionability | Includes one fully executable command (`python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py" scrape <landing-url> --mobile`) plus concrete per-check Pass/Partial/Fix criteria and explicit Measured/Estimated labeling rules. Fits anchor 4 (mostly executable, minor gaps); not 5 because the five checks are directive prose without per-check commands or examples beyond the single scraper invocation. | 4 / 5 |
Workflow Clarity | Eight clearly sequenced steps, an input-confirmation step with an explicit NEEDS_INPUT stop path, a four-item "Quality bar before handoff" checklist, and a feedback loop ("If any item fails, fix it or report it in the handoff — do not ship silently"). Matches anchor 5 with explicit validation checkpoints and error-recovery guidance; not 4 because checkpoints are explicit rather than implied. | 5 / 5 |
Progressive Disclosure | Well-organized sections (Quick Start, Skill Contract, Data Sources, Instructions, Save Results, Reference Materials, Next Best Skill) with clearly signaled, one-line-annotated references. Fits anchor 4; not 5 because every referenced file ([skill-contract.md](../../../references/skill-contract.md), [CONNECTORS.md](../../../CONNECTORS.md), [scripts/connectors/README.md](../../../scripts/connectors/README.md)) resolves outside the skill directory and no bundle files (references/, scripts/, assets/) exist to verify, so navigation rests on unverifiable cross-repo paths. | 4 / 5 |
Total | 16 / 20 Passed |