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-organized, largely lean body with concrete CLI commands, an explicit pre-flight gate, and valuable domain-specific tables (industry thresholds, anti-patterns). The main defect is bundle integrity: every referenced reference/ and scripts/ path is missing from the bundle, so the skill's navigation and commands cannot actually be followed as shipped.
Suggestions
Ship the bundle: include the five references/*.md files and the three scripts/*.py files that the body cites — the References section and every workflow command currently point at files that do not exist in the bundle.
Move the 'Industry-Specific E-E-A-T Thresholds' table and the 'Anti-Patterns Rejected' section into references/aeo_eeat_canon.md (which already advertises 'industry thresholds, anti-patterns') and keep only a one-line pointer plus the two or three most common industries inline.
Add an explicit validation step to the workflow, e.g., after optimization: review the optimizer diff and re-run aeo_audit.py on the optimized variant to confirm the composite score improved before publishing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious domain specifics (E-E-A-T dimension definitions, per-industry threshold table, citation-ledger CLI usage, anti-pattern list) that Claude would not already know, so most tokens earn their place. It sits at the 4 anchor rather than 5 due to minor trim candidates: the 'Trigger Phrases' section duplicates the frontmatter description, the 'Both can coexist...' prose under 'Distinct From SEO' explains concepts Claude already knows (SEO rewards backlinks/keywords), and the version/source footer adds metadata tokens; it is above the 3 anchor because there is no substantial padded explanation. | 4 / 5 |
Actionability | Quotes: '$ python3 scripts/aeo_audit.py --url https://example.com/blog/post', '$ python3 scripts/aeo_optimizer.py --input post.md --mode balanced --output post-aeo.md', 'python3 scripts/aeo_audit.py --url <url> --industry healthcare', and tracker add/report invocations — concrete, flag-level commands for the common cases, plus a full example output report. This matches the 4 anchor ('concrete code or commands with minor gaps') rather than 5 because the optimizer's output is never exemplified, the 'query_research mode' is mentioned only as scaffold-only with no usage, and the audit report example contains '[...]' placeholders. | 4 / 5 |
Workflow Clarity | The numbered 0-4 workflow is clearly sequenced with a real command and expected output ('→ markdown report with composite score + 4-dimension breakdown') per step, and step 0 is an explicit gating pre-check ('a blocked GPTBot/PerplexityBot/ClaudeBot/Google-Extended is the first fix, always'). This matches the 4 anchor; it is not 5 because there is no explicit validation or error-recovery step (e.g., reviewing the optimizer diff before publishing, or what to do when the audit scores below an industry threshold), and it is above the 3 anchor because checkpoints are not merely implicit — the pre-flight gate and per-step expected outputs are stated. | 4 / 5 |
Progressive Disclosure | References are clearly signaled with one-line descriptions ('references/aeo_eeat_canon.md — E-E-A-T methodology, industry thresholds, anti-patterns') and are one level deep, but none of the referenced files exist in the bundle — there are no references/, scripts/, or assets/ directories, so all 5 reference paths and all 3 script paths are dangling. Additionally, content that the reference descriptions say lives in those files (the industry-threshold table duplicating 'aeo_eeat_canon.md' territory, and the Anti-Patterns section overlapping the canon's 'anti-patterns') is inlined in the body. Good signaling but broken navigation and duplicated placement matches the 3 anchor ('structure present but content that should be separate is inline / references do not resolve); it is above 2 because the body itself is well sectioned and not an unstructured monolith, and below 4 because referenced paths do not resolve to real files. | 3 / 5 |
Total | 15 / 20 Passed |