Content Quality & E-E-A-T Analysis

Content quality and E-E-A-T analysis with AI citation readiness assessment, plus last-mile draft cleanup (AI-typical phrasing and invisible Unicode watermark characters).

How to use it

  1. Hit Copy SKILL.md — or use the Claude Code line below to get every file.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit AgriciDaniel/claude-seo/skills/seo-content#main ~/.claude/skills/seo-content

For one project only, change the path to .claude/skills/seo-content. This skill also uses content_humanize.py, draft.md, cleaned.md — copying SKILL.md alone won't be enough. See the folder on GitHub.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text238 lines
seo-content/SKILL.md238 lines11.7 KBpushed 11d agoRawView on GitHub

Content Quality & E-E-A-T Analysis

Google's "Who / How / Why" Test (canonical heuristic)

Before scoring E-E-A-T sub-factors, every page audit should pass Google's own three-question heuristic from the helpful-content guide:

Question What to look for
Who created it? Visible byline, author bio page, professional credentials. Required where readers expect it; non-negotiable for YMYL.
How was it created? Process disclosure where readers would reasonably ask, especially for AI-assisted content. Original research / first-hand evidence / lived experience.
Why does it exist? "To help people" rather than "to attract search clicks." Watch for niche entry without expertise, content churn for freshness signals, content written to a word-count target.

Primary source: https://developers.google.com/search/docs/fundamentals/creating-helpful-content

When all three answers are weak, the page is at risk under the core ranking system's helpfulness signals (formerly the standalone Helpful Content System, merged into core during the March 2024 update).

E-E-A-T Framework (updated Sept 2025 QRG)

Read skills/seo/references/eeat-framework.md for full criteria.

Experience (first-hand signals)

  • Original research, case studies, before/after results
  • Personal anecdotes, process documentation
  • Unique data, proprietary insights
  • Photos/videos from direct experience

Expertise

  • Author credentials, certifications, bio
  • Professional background relevant to topic
  • Technical depth appropriate for audience
  • Accurate, well-sourced claims

Authoritativeness

  • External citations, backlinks from authoritative sources
  • Brand mentions, industry recognition
  • Published in recognized outlets
  • Cited by other experts

Trustworthiness

  • Contact information, physical address
  • Privacy policy, terms of service
  • Customer testimonials, reviews
  • Date stamps, transparent corrections
  • Secure site (HTTPS)

Content Metrics

Word Count Analysis

Compare against page type minimums:

Page Type Minimum
Homepage 500
Service page 800
Blog post 1,500
Product page 300+ (400+ for complex products)
Location page 500-600

Important: These are topical coverage floors, not targets. Google has confirmed word count is NOT a direct ranking factor. The goal is comprehensive topical coverage; a 500-word page that thoroughly answers the query will outrank a 2,000-word page that doesn't. Use these as guidelines for adequate coverage depth, not rigid requirements.

Readability

  • Flesch Reading Ease: target 60-70 for general audience

Note: Flesch Reading Ease is a useful proxy for content accessibility but is NOT a direct Google ranking factor. John Mueller has confirmed Google does not use basic readability scores for ranking. Yoast deprioritized Flesch scores in v19.3. Use readability analysis as a content quality indicator, not as an SEO metric to optimize directly.

  • Grade level: match target audience
  • Sentence length: average 15-20 words
  • Paragraph length: 2-4 sentences

Keyword Optimization

  • Primary keyword in title, H1, first 100 words
  • Natural density (1-3%)
  • Semantic variations present
  • No keyword stuffing

Content Structure

  • Logical heading hierarchy (H1 -> H2 -> H3)
  • Scannable sections with descriptive headings
  • Bullet/numbered lists where appropriate
  • Table of contents for long-form content

Multimedia

  • Relevant images with proper alt text
  • Videos where appropriate
  • Infographics for complex data
  • Charts/graphs for statistics

Internal Linking

  • 3-5 relevant internal links per 1000 words
  • Descriptive anchor text
  • Links to related content
  • No orphan pages

External Linking

  • Cite authoritative sources
  • Open in new tab for user experience
  • Reasonable count (not excessive)

AI Content Assessment (Sept 2025 QRG addition)

Google's raters assess low-quality, scaled, copied, or AI-generated main content patterns rather than AI authorship as a standalone issue.

Acceptable AI Content

  • Demonstrates genuine E-E-A-T
  • Provides unique value
  • Has human oversight and editing
  • Contains original insights

Low-Quality AI Content Markers

  • Generic phrasing, lack of specificity
  • No original insight
  • Repetitive structure across pages
  • No author attribution
  • Factual inaccuracies

Helpful Content System (March 2024): The Helpful Content System was merged into Google's core ranking algorithm during the March 2024 core update. It no longer operates as a standalone classifier. Helpfulness signals are now weighted within every core update. The same principles apply (people-first content, demonstrating E-E-A-T, satisfying user intent), but enforcement is continuous rather than through separate HCU updates. Google now also documents continuous, smaller unannounced core updates between major ones (changelog 2025-12-09).

Gen-AI optimization is SEO (Google docs, 2026-06-29): the official "optimizing for generative AI features" guide states you do not need new AI files, markup, Markdown, content chunking, or AI-specific rewrites; chasing inauthentic "mentions" is unhelpful. AEO/GEO is rebranded SEO rooted in core ranking/quality.

Honest scoping (Google docs, 2026-06-05): per "Using third-party SEO tools, services, and advice," no tool guarantees rankings and third-party tools have no access to Google's internal ranking data. claude-seo's scores are heuristics, not Google-internal signals, so say so in reports, and validate GEO/AEO findings against Google's official guidance (Search Console is the first-party source).

Draft Cleanup: AI Phrasing & Invisible Watermarks

For "humanize this", "remove watermarks", or "clean up this draft", run the bundled cleanup script on the user's own content:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run content_humanize.py draft.md -o cleaned.md
cat draft.md | "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run content_humanize.py --json

Two deterministic passes, both logged in the JSON output:

  1. Invisible characters (invisible_removed): strips zero-width codepoints, directional marks/overrides, Unicode tag characters (hidden text smuggling), and normalizes exotic spaces. Emoji sequences (ZWJ, variation selectors next to emoji) are preserved.
  2. AI-typical phrasing (changes): conservative 1:1 swaps from the replacement table ("delve into" → "explore", etc.). Nothing is paraphrased or added.

Scope honesty: statistical watermarks (SynthID-style token-probability schemes) live in word choice, not codepoints. No tool reliably detects or removes them; do not claim otherwise in reports. This cleanup is for editing the user's own drafts, not for laundering third-party content — decline requests to strip provenance from content the user doesn't own.

AI Citation Readiness (GEO signals)

Optimize for AI search engines (ChatGPT, Perplexity, Google AI Overviews):

  • Clear, quotable statements with statistics/facts
  • Structured data (especially for data points)
  • Strong heading hierarchy (H1->H2->H3 flow)
  • Answer-first formatting for key questions
  • Tables and lists for comparative data
  • Clear attribution and source citations

AI Search Visibility & GEO (2025-2026)

Google AI Mode is Google's conversational AI search surface. Google's last official model naming for AI Mode / AI Overviews is a custom version of Gemini 2.5. Treat third-party AI Mode usage, citation, and link-share figures as methodology-dependent unless primary-sourced, and optimize for both AI Mode and AI Overviews (see the seo-geo skill).

Key optimization strategies for AI citation:

  • Structured answers: Clear question-answer formats, definition patterns, and step-by-step instructions that AI systems can extract and cite
  • First-party data: Original research, statistics, case studies, and unique datasets are highly cited by AI systems
  • Schema markup: Article and other relevant structured content. FAQPage no longer produces Google FAQ rich results; use QAPage only for genuine user Q&A where appropriate
  • Topical authority: AI systems preferentially cite sources that demonstrate deep expertise. Build content clusters, not isolated pages
  • Entity clarity: Ensure brand, authors, and key concepts are clearly defined with structured data (Organization, Person schema)
  • Multi-platform tracking: Monitor visibility across Google AI Overviews, AI Mode, ChatGPT, Perplexity, and Bing Copilot, not just traditional rankings. Treat AI citation as a standalone KPI alongside organic rankings and traffic.

Generative Engine Optimization (GEO): Per Google's AI optimization guide, "AEO" and "GEO" are rebranded labels for SEO: AI Overviews and AI Mode are grounded in the same ranking and quality systems as classic Search. The optimization signals that matter (quotability, attribution, heading hierarchy, freshness) are SEO fundamentals applied to AI-search surfaces, not a separate discipline. Cross-reference the seo-geo skill for detailed workflows; both surfaces share the primary-source synthesis in skills/seo-geo/references/google-ai-optimization-guide.md.

Content Freshness

  • Publication date visible
  • Last updated date if content has been revised
  • Flag content older than 12 months without update for fast-changing topics

Output

Content Quality Score: XX/100

E-E-A-T Breakdown

Factor Score Key Signals
Experience XX/20 ...
Expertise XX/25 ...
Authoritativeness XX/25 ...
Trustworthiness XX/30 ...

Weights are this skill's own scoring model, ordered to reflect Google's stated hierarchy: Trust is most important (30), then Expertise/ Authoritativeness (25 each), then Experience (20); maxima sum to 100. Google publishes no numeric E-E-A-T weights (only that trust is most important), so treat the split as our internal model. Do not use an equal 25/25/25/25 split (it contradicts Google's "trust is most important").

AI Citation Readiness: XX/100

Issues Found

Recommendations

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, use kw_data_google_ads_search_volume for real keyword volume data, dataforseo_labs_bulk_keyword_difficulty for difficulty scores, dataforseo_labs_search_intent for intent classification, and content_analysis_summary for content quality analysis.

Error Handling

Scenario Action
URL unreachable (DNS failure, connection refused) Report the error clearly. Do not guess page content. Suggest the user verify the URL and try again.
Content behind paywall (402/403, login wall) Report that the content is not publicly accessible. Analyze only the visible portion (meta tags, headers) and note the limitation.
Thin content (fewer than 100 words retrievable) Report the findings as-is rather than guessing. Flag the page as potentially JavaScript-rendered or gated, and suggest the user provide the full text directly.

FLOW Framework Integration

For prompt-guided content optimization, use /seo flow optimize <url> and /seo flow win <url>: FLOW's optimize and win prompts provide structured E-E-A-T improvement and BOFU conversion workflows.

1---
2name: seo-content
3description: >
4 Content quality and E-E-A-T analysis with AI citation readiness assessment,
5 plus last-mile draft cleanup (AI-typical phrasing and invisible Unicode
6 watermark characters). Use when user says "content quality", "E-E-A-T",
7 "content analysis", "readability check", "thin content", "content audit",
8 "humanize", "AI phrasing", "remove watermarks", or "invisible characters".
9user-invocable: true
10argument-hint: "[url]"
11license: MIT
12metadata:
13 author: AgriciDaniel
14 version: "2.3.1"
15 category: seo
16---
17 
18# Content Quality & E-E-A-T Analysis
19 
20## Google's "Who / How / Why" Test (canonical heuristic)
21 
22Before scoring E-E-A-T sub-factors, every page audit should pass Google's
23own three-question heuristic from the helpful-content guide:
24 
25| Question | What to look for |
26|---|---|
27| **Who** created it? | Visible byline, author bio page, professional credentials. Required where readers expect it; non-negotiable for YMYL. |
28| **How** was it created? | Process disclosure where readers would reasonably ask, especially for AI-assisted content. Original research / first-hand evidence / lived experience. |
29| **Why** does it exist? | "To help people" rather than "to attract search clicks." Watch for niche entry without expertise, content churn for freshness signals, content written to a word-count target. |
30 
31Primary source:
32https://developers.google.com/search/docs/fundamentals/creating-helpful-content
33 
34When all three answers are weak, the page is at risk under the core ranking
35system's helpfulness signals (formerly the standalone Helpful Content System,
36merged into core during the March 2024 update).
37 
38## E-E-A-T Framework (updated Sept 2025 QRG)
39 
40Read `skills/seo/references/eeat-framework.md` for full criteria.
41 
42### Experience (first-hand signals)
43- Original research, case studies, before/after results
44- Personal anecdotes, process documentation
45- Unique data, proprietary insights
46- Photos/videos from direct experience
47 
48### Expertise
49- Author credentials, certifications, bio
50- Professional background relevant to topic
51- Technical depth appropriate for audience
52- Accurate, well-sourced claims
53 
54### Authoritativeness
55- External citations, backlinks from authoritative sources
56- Brand mentions, industry recognition
57- Published in recognized outlets
58- Cited by other experts
59 
60### Trustworthiness
61- Contact information, physical address
62- Privacy policy, terms of service
63- Customer testimonials, reviews
64- Date stamps, transparent corrections
65- Secure site (HTTPS)
66 
67## Content Metrics
68 
69### Word Count Analysis
70Compare against page type minimums:
71| Page Type | Minimum |
72|-----------|---------|
73| Homepage | 500 |
74| Service page | 800 |
75| Blog post | 1,500 |
76| Product page | 300+ (400+ for complex products) |
77| Location page | 500-600 |
78 
79> **Important:** These are **topical coverage floors**, not targets. Google has confirmed word count is NOT a direct ranking factor. The goal is comprehensive topical coverage; a 500-word page that thoroughly answers the query will outrank a 2,000-word page that doesn't. Use these as guidelines for adequate coverage depth, not rigid requirements.
80 
81### Readability
82- Flesch Reading Ease: target 60-70 for general audience
83 
84> **Note:** Flesch Reading Ease is a useful proxy for content accessibility but is NOT a direct Google ranking factor. John Mueller has confirmed Google does not use basic readability scores for ranking. Yoast deprioritized Flesch scores in v19.3. Use readability analysis as a content quality indicator, not as an SEO metric to optimize directly.
85- Grade level: match target audience
86- Sentence length: average 15-20 words
87- Paragraph length: 2-4 sentences
88 
89### Keyword Optimization
90- Primary keyword in title, H1, first 100 words
91- Natural density (1-3%)
92- Semantic variations present
93- No keyword stuffing
94 
95### Content Structure
96- Logical heading hierarchy (H1 -> H2 -> H3)
97- Scannable sections with descriptive headings
98- Bullet/numbered lists where appropriate
99- Table of contents for long-form content
100 
101### Multimedia
102- Relevant images with proper alt text
103- Videos where appropriate
104- Infographics for complex data
105- Charts/graphs for statistics
106 
107### Internal Linking
108- 3-5 relevant internal links per 1000 words
109- Descriptive anchor text
110- Links to related content
111- No orphan pages
112 
113### External Linking
114- Cite authoritative sources
115- Open in new tab for user experience
116- Reasonable count (not excessive)
117 
118## AI Content Assessment (Sept 2025 QRG addition)
119 
120Google's raters assess low-quality, scaled, copied, or AI-generated main content patterns rather than AI authorship as a standalone issue.
121 
122### Acceptable AI Content
123- Demonstrates genuine E-E-A-T
124- Provides unique value
125- Has human oversight and editing
126- Contains original insights
127 
128### Low-Quality AI Content Markers
129- Generic phrasing, lack of specificity
130- No original insight
131- Repetitive structure across pages
132- No author attribution
133- Factual inaccuracies
134 
135> **Helpful Content System (March 2024):** The Helpful Content System was merged into Google's core ranking algorithm during the March 2024 core update. It no longer operates as a standalone classifier. Helpfulness signals are now weighted within every core update. The same principles apply (people-first content, demonstrating E-E-A-T, satisfying user intent), but enforcement is continuous rather than through separate HCU updates. Google now also documents **continuous, smaller unannounced core updates** between major ones (changelog 2025-12-09).
136 
137> **Gen-AI optimization is SEO (Google docs, 2026-06-29):** the official "optimizing for generative AI features" guide states you do **not** need new AI files, markup, Markdown, content chunking, or AI-specific rewrites; chasing inauthentic "mentions" is unhelpful. AEO/GEO is rebranded SEO rooted in core ranking/quality.
138 
139> **Honest scoping (Google docs, 2026-06-05):** per "Using third-party SEO tools, services, and advice," no tool guarantees rankings and third-party tools have no access to Google's internal ranking data. claude-seo's scores are **heuristics**, not Google-internal signals, so say so in reports, and validate GEO/AEO findings against Google's official guidance (Search Console is the first-party source).
140 
141## Draft Cleanup: AI Phrasing & Invisible Watermarks
142 
143For "humanize this", "remove watermarks", or "clean up this draft", run the
144bundled cleanup script on the user's own content:
145 
146```bash
147"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run content_humanize.py draft.md -o cleaned.md
148cat draft.md | "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run content_humanize.py --json
149```
150 
151Two deterministic passes, both logged in the JSON output:
152 
1531. **Invisible characters** (`invisible_removed`): strips zero-width
154 codepoints, directional marks/overrides, Unicode tag characters (hidden
155 text smuggling), and normalizes exotic spaces. Emoji sequences (ZWJ,
156 variation selectors next to emoji) are preserved.
1572. **AI-typical phrasing** (`changes`): conservative 1:1 swaps from the
158 replacement table ("delve into" → "explore", etc.). Nothing is
159 paraphrased or added.
160 
161Scope honesty: statistical watermarks (SynthID-style token-probability
162schemes) live in word choice, not codepoints. No tool reliably detects or
163removes them; do not claim otherwise in reports. This cleanup is for
164editing the user's own drafts, not for laundering third-party content —
165decline requests to strip provenance from content the user doesn't own.
166 
167## AI Citation Readiness (GEO signals)
168 
169Optimize for AI search engines (ChatGPT, Perplexity, Google AI Overviews):
170 
171- Clear, quotable statements with statistics/facts
172- Structured data (especially for data points)
173- Strong heading hierarchy (H1->H2->H3 flow)
174- Answer-first formatting for key questions
175- Tables and lists for comparative data
176- Clear attribution and source citations
177 
178### AI Search Visibility & GEO (2025-2026)
179 
180**Google AI Mode** is Google's conversational AI search surface. Google's last official model naming for AI Mode / AI Overviews is a custom version of **Gemini 2.5**. Treat third-party AI Mode usage, citation, and link-share figures as methodology-dependent unless primary-sourced, and optimize for both AI Mode and AI Overviews (see the `seo-geo` skill).
181 
182**Key optimization strategies for AI citation:**
183- **Structured answers:** Clear question-answer formats, definition patterns, and step-by-step instructions that AI systems can extract and cite
184- **First-party data:** Original research, statistics, case studies, and unique datasets are highly cited by AI systems
185- **Schema markup:** Article and other relevant structured content. FAQPage no longer produces Google FAQ rich results; use QAPage only for genuine user Q&A where appropriate
186- **Topical authority:** AI systems preferentially cite sources that demonstrate deep expertise. Build content clusters, not isolated pages
187- **Entity clarity:** Ensure brand, authors, and key concepts are clearly defined with structured data (Organization, Person schema)
188- **Multi-platform tracking:** Monitor visibility across Google AI Overviews, AI Mode, ChatGPT, Perplexity, and Bing Copilot, not just traditional rankings. Treat AI citation as a standalone KPI alongside organic rankings and traffic.
189 
190**Generative Engine Optimization (GEO):**
191Per Google's AI optimization guide, "AEO" and "GEO" are rebranded labels for SEO: AI Overviews and AI Mode are grounded in the same ranking and quality systems as classic Search. The optimization signals that matter (quotability, attribution, heading hierarchy, freshness) are SEO fundamentals applied to AI-search surfaces, not a separate discipline. Cross-reference the `seo-geo` skill for detailed workflows; both surfaces share the primary-source synthesis in `skills/seo-geo/references/google-ai-optimization-guide.md`.
192 
193## Content Freshness
194 
195- Publication date visible
196- Last updated date if content has been revised
197- Flag content older than 12 months without update for fast-changing topics
198 
199## Output
200 
201### Content Quality Score: XX/100
202 
203### E-E-A-T Breakdown
204| Factor | Score | Key Signals |
205|--------|-------|-------------|
206| Experience | XX/20 | ... |
207| Expertise | XX/25 | ... |
208| Authoritativeness | XX/25 | ... |
209| Trustworthiness | XX/30 | ... |
210 
211> Weights are **this skill's own scoring model**, ordered to reflect Google's
212> stated hierarchy: **Trust is most important** (30), then Expertise/
213> Authoritativeness (25 each), then Experience (20); maxima sum to 100. Google
214> publishes no numeric E-E-A-T weights (only that trust is most important), so
215> treat the split as our internal model. Do not use an equal 25/25/25/25 split
216> (it contradicts Google's "trust is most important").
217 
218### AI Citation Readiness: XX/100
219 
220### Issues Found
221### Recommendations
222 
223## DataForSEO Integration (Optional)
224 
225If DataForSEO MCP tools are available, use `kw_data_google_ads_search_volume` for real keyword volume data, `dataforseo_labs_bulk_keyword_difficulty` for difficulty scores, `dataforseo_labs_search_intent` for intent classification, and `content_analysis_summary` for content quality analysis.
226 
227## Error Handling
228 
229| Scenario | Action |
230|----------|--------|
231| URL unreachable (DNS failure, connection refused) | Report the error clearly. Do not guess page content. Suggest the user verify the URL and try again. |
232| Content behind paywall (402/403, login wall) | Report that the content is not publicly accessible. Analyze only the visible portion (meta tags, headers) and note the limitation. |
233| Thin content (fewer than 100 words retrievable) | Report the findings as-is rather than guessing. Flag the page as potentially JavaScript-rendered or gated, and suggest the user provide the full text directly. |
234 
235## FLOW Framework Integration
236 
237For prompt-guided content optimization, use `/seo flow optimize <url>` and `/seo flow win <url>`: FLOW's optimize and win prompts provide structured E-E-A-T improvement and BOFU conversion workflows.
238 

Discussion

Alternatives

Also in SEO & keywords