Content
71%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-structured, actionable skill body that uses progressive disclosure effectively and gives concrete audit/optimization guidance. Its main weakness is redundancy between the 'What NOT to Do' and 'Common Mistakes' sections and between the two question-gathering blocks, which inflates token cost.
Suggestions
Merge 'What NOT to Do' and 'Common Mistakes' into a single section; they repeat the same points (blocking AI bots, gating content, keyword stuffing, writing separate AI content) and roughly halve that token cost.
Consolidate 'Before Starting' context-gathering and 'Task-Specific Questions' into one question list; they overlap on top queries, schema markup, competitors, and Wikipedia/review presence.
Move the Princeton GEO method table and the platform source-selection table into a reference file (e.g. platform-ranking-factors.md) and summarize the top findings inline, shortening the main SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense with tables and stats rather than padding about basics Claude knows, but at ~480 lines it carries real redundancy: 'What NOT to Do' and 'Common Mistakes' overlap heavily (AI-bot blocking, gating, keyword stuffing, writing for AI) and 'Before Starting' questions overlap 'Task-Specific Questions'. | 3 / 5 |
Actionability | Provides concrete executable guidance — a copy-paste /pricing.md block, named AI bots to check in robots.txt, schema types per content type, the Princeton GEO boost table, and a 4-step DIY monitoring procedure — with only minor abstract guidance remaining. | 4 / 5 |
Workflow Clarity | The AI Visibility Audit is clearly sequenced (check answers → analyze citations → extractability check → bot access check) and is not a destructive/batch operation, so the validation cap does not apply; each audit step is itself a verification check, leaving only minor explicit-checkpoint gaps. | 4 / 5 |
Progressive Disclosure | Eight reference files exist in references/ and all eight are linked one level deep with clear markdown links and brief content descriptions (platform-ranking-factors, content-patterns, agent-readiness, format-volatility, youtube-ai-citations, okf, citations-vs-recommendations, content-types), keeping SKILL.md as an overview with deep material split out. | 5 / 5 |
Total | 16 / 20 Passed |