Content
75%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, command-driven skill body: fully executable invocations for all three tools, a clearly sequenced workflow with an explicit pre-flight gating check, and well-signaled references that all exist on disk. Its main weakness is duplication — the industry thresholds and anti-patterns sections restate reference-file content inline, and the Trigger Phrases section repeats the description — which costs both conciseness and some progressive-disclosure organization.
Suggestions
Replace the inline "Industry-Specific E-E-A-T Thresholds" table with a one-line pointer to the corresponding section in references/aeo_eeat_canon.md (the reference already carries the table plus YMYL rationale).
Trim "Anti-Patterns Rejected" to the six bolded names with one-line summaries, or point to the Anti-Patterns section of references/aeo_eeat_canon.md for the justifications.
Drop the "Trigger Phrases" section (it duplicates the frontmatter description) and the porting-history footer paragraph, which spends tokens on provenance rather than guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and command-driven with no explanation of concepts Claude already knows, but several sections are tightening candidates: the "Industry-Specific E-E-A-T Thresholds" table (8 industries) and "Anti-Patterns Rejected" substantially duplicate content already in references/aeo_eeat_canon.md, the "Trigger Phrases" section repeats the frontmatter description verbatim in spirit, and the porting-history footer ("2,464 LOC across 9 modules …") adds little operational value. This fits anchor 3 (mostly efficient but could be tightened) better than anchor 2, since the duplicated material is a minority of the file and everything else earns its tokens. | 3 / 5 |
Actionability | Every tool has a copy-paste-ready invocation with real flags and example values: "python3 scripts/aeo_audit.py --url https://example.com/blog/post", "aeo_optimizer.py --input post.md --mode balanced --output post-aeo.md", and a fully parameterized citation_tracker add/report pair; the three scripts all exist in scripts/. Concrete output samples (the markdown report template) and a worked configuration example (--industry healthcare) cover the common cases — anchor 5. | 5 / 5 |
Workflow Clarity | The workflow is a clearly numbered 0–4 sequence, each step paired with a concrete command and its expected result ("→ markdown report with composite score + 4-dimension breakdown"), and step 0 is an explicit gating checkpoint ("a blocked GPTBot/PerplexityBot/ClaudeBot/Google-Extended is the first fix, always"). It falls short of anchor 5 because there are no feedback loops (e.g., re-audit after applying fixes, or verify the optimizer's output before publishing); the operations are non-destructive (optimizer writes to a new output file), so the destructive-operation cap at 3 does not apply. | 4 / 5 |
Progressive Disclosure | The References section clearly signals all five one-level-deep reference files with one-line descriptions of each, and all five exist in references/ (verified), as do the three scripts named in Core Capabilities. The gap keeping it at anchor 4 rather than 5 is that the industry-thresholds table and anti-patterns list are inlined in SKILL.md despite being covered by references/aeo_eeat_canon.md, and the Trigger Phrases section duplicates the frontmatter rather than pointing into the body's structure. | 4 / 5 |
Total | 16 / 20 Passed |