Content
11%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 body is a well-formatted but generic SEO concept primer that restates widely known knowledge, provides no executable guidance, and completely fails to surface the bundled seo_checker.py script — the one asset that would have made the skill actionable. It reads as educational reference material rather than a skill that instructs Claude to do anything.
Suggestions
Replace the concept-primer tables with actionable guidance, and reference the bundled audit tool explicitly (e.g. 'Run `python scripts/seo_checker.py <project_path>` to audit pages for meta tags, Open Graph, heading hierarchy, and alt attributes').
Cut or drastically compress sections that restate knowledge Claude already has (E-E-A-T definitions, CWV thresholds, robots.txt/sitemap purposes) and keep only genuinely non-obvious judgment calls (e.g. the relative-importance table).
Define at least one concrete workflow (audit -> interpret findings -> prioritize fixes) with validation checkpoints so the content instructs rather than describes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly the entire body restates knowledge Claude already has — E-E-A-T dimensions, CWV thresholds ("LCP < 2.5s", "INP < 200ms", "CLS < 0.1"), the purpose of robots.txt/sitemaps/canonical tags, and title tag best practices — matching anchor 2 ('noticeably verbose; several unnecessary explanations'). It avoids anchor 1 only because the table format is compact rather than padded prose, but it is not a 3+ since almost no token adds information Claude lacks. | 2 / 5 |
Actionability | The body contains no code, commands, or concrete instructions — it only describes concepts ('Title tag: Clear topic + intent', 'Technical SEO ensures pages are accessible'). This matches anchor 1 ('entirely vague or abstract; no concrete code or commands; only describes rather than instructs'), made worse by the fact that an executable script (scripts/seo_checker.py) exists in the bundle yet is never invoked or shown. | 1 / 5 |
Workflow Clarity | There is no multi-step process, sequence, or task flow anywhere in the body — it is a topical concept reference, matching anchor 1 ('steps missing or incoherent; no sequence'). The simple-skill exception does not apply because no single unambiguous action is defined either; the body never tells Claude what to do with these principles. | 1 / 5 |
Progressive Disclosure | The bundle contains scripts/seo_checker.py (a 219-line executable SEO audit tool), but the body never mentions or links to it — the skill's only executable asset is undiscoverable, matching anchor 2 ('minimal structure; references are buried'). It is not a 3 because no reference to the script is 'present but weakly signaled'; it is entirely absent, despite the body being well-sectioned otherwise. | 2 / 5 |
Total | 6 / 20 Passed |