Content
57%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.
The skill is well structured with an excellent one-level-deep pointer to references/rule.md, and the audit/fix guidance is concrete with real inconsistency examples. Its weaknesses are redundancy — the same check instructions appear in Quick Reference, Check, and Code Review, and Explain covers SEO concepts Claude already knows — and a missing post-fix verification step for what is a batch, multi-page edit.
Suggestions
Collapse 'Check' and 'Code Review' into a single section (they are near-verbatim duplicates) and drop or shrink the 'Quick Reference' bullets that repeat the same points — this would cut the body by roughly a third.
Add an explicit validation loop after 'Fix': 'Re-run the site-wide search and the JSON-LD-vs-visible-text comparison; only report success when zero mismatches remain.'
Trim the 'Explain' section's background on how Google cross-references NAP (concept knowledge Claude already has) to a one-line rationale, keeping the token budget for actionable detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The same instructions appear three times: the 'Check' section ('Search the site for all instances of the business name, street address, and phone number... check JSON-LD LocalBusiness schema against the visible text') is nearly verbatim duplicated in 'Code Review' ('Extract all instances of the business name, street address, and phone number... compare against visible HTML text'), and the 'Quick Reference' bullets repeat both a third time. The 'Explain' section also teaches a concept Claude already knows ('NAP consistency is a local SEO ranking factor. Google cross-references...'). This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') — above 1 because each section is individually terse and on-topic, but below 3 because the duplication and the concept explanation are clear padding that could be cut to roughly a third of the body. | 2 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: exact comparison targets ('St.' vs 'Street', '555-1234' vs '(555) 123-4567', suite notation), a clear canonical-format decision process in 'Fix' ('Choose one format for each field: full street name vs abbreviation, phone number formatting, suite/unit notation'), and named locations to check (footer, contact page, about page, structured data). This matches anchor 4 ('mostly executable guidance... with minor gaps') — below 5 because there are no commands or report format (e.g., a site-wide search command or the output format for 'Report any differences'), and the body defers all code examples to references/rule.md; above 3 because the guidance is specific and directly executable, not pseudocode. | 4 / 5 |
Workflow Clarity | A rough sequence exists (Check → Fix → Explain), but the near-duplicate 'Check' and 'Code Review' sections muddy which procedure to follow and in what order, and there is no validation checkpoint after the batch 'Fix' step ('Update all pages, footer, contact page, about page, and structured data') — nothing says to re-run the comparison to confirm zero remaining inconsistencies. This matches anchor 3 ('steps listed but validation gaps') and the rubric's cap for batch operations without a feedback loop; below 4 because a multi-page batch edit with no re-verify step is a missing checkpoint, above 2 because the audit-then-fix order is coherent and the check itself is well defined. | 3 / 5 |
Progressive Disclosure | The body is a clear, well-organized overview (Quick Reference / Check / Fix / Explain / Code Review) with a single, clearly signaled, one-level-deep reference: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and references/rule.md exists and delivers exactly that (inconsistency patterns table, where-to-check list, HTML/JSON-LD examples, verification steps). No nested references exist. This matches anchor 5 ('clear overview with well-signaled one-level-deep references') — the body keeps examples inline and pushes depth to the reference file appropriately. | 5 / 5 |
Total | 14 / 20 Passed |