SEO Content Optimizer skill

Optimize content for search engines with keyword analysis, readability scoring, meta descriptions, and competitor comparison.

by OneWave-AI·MIT license·GitHub ↗

★ 306 Stars on the repo·Checked

npx degit OneWave-AI/claude-skills/seo-optimizer#main ~/.claude/skills/seo-optimizer

SKILL.md · 6.6 KB · installs the whole folder to ~/.claude/skills/seo-optimizer

Files of SEO Content Optimizer

Files 1 file
Show the full text233 lines

SEO Content Optimizer

Comprehensive SEO analysis and optimization for content creators and marketers.

To optimize content for SEO, provide a detailed analysis covering keywords, readability, technical SEO, and actionable recommendations.

Instructions

1. Analyze Target Keywords

Examine keyword usage and placement:

  • Identify primary keyword(s) from user input or content
  • Check keyword placement (title, H1, first 100 words, subheadings)
  • Calculate keyword density (aim for 1-2%)
  • Identify LSI keywords and semantic variations present
  • Flag keyword stuffing issues
2. Evaluate Content Structure

Assess the organization and hierarchy:

  • Check heading hierarchy (single H1, then multiple H2, then H3)
  • Verify keyword usage in headings
  • Evaluate heading descriptiveness
  • Check paragraph length (aim for <150 words)
  • Assess overall scanability
3. Readability Analysis

Calculate readability metrics:

  • Flesch Reading Ease score (aim for 60-70)
  • Grade level estimation
  • Average sentence length (aim for <20 words)
  • Passive voice percentage (minimize)
  • Transition word usage
  • Paragraph structure
4. Technical SEO Elements

Generate optimized meta elements:

  • Meta Title: 50-60 characters with primary keyword
  • Meta Description: 150-160 characters, compelling with keyword
  • URL Slug: Short, keyword-rich, hyphen-separated
  • Image Alt Text: Descriptive with keywords where natural
  • Internal Linking: Opportunities to link to related content
  • External Links: Quality of outbound links
5. Content Quality Assessment

Evaluate comprehensiveness:

  • Word count (competitive topics need 1500+ words)
  • Content depth and detail level
  • Topic coverage completeness
  • Unique value proposition
  • E-A-T signals (expertise, authority, trust)
  • Content freshness (dates, current examples)
6. Provide Actionable Recommendations

Prioritize improvements by impact:

Critical (Fix Immediately):

  • Missing or poor meta description
  • No keyword in title or H1
  • Broken internal links
  • Keyword density too high/low

High Priority:

  • Poor readability score
  • Weak heading structure
  • Missing alt text on images
  • Content too thin

Medium Priority:

  • Could add related keywords
  • Opportunity for featured snippet
  • Could improve internal linking

Provide specific, actionable fixes with examples.

Output Format

# SEO Analysis Report

## Overall Score: X/100

### Target Keywords
- Primary: [keyword] (density: X.X%)
- Secondary: [keyword 1], [keyword 2]
- LSI Keywords Found: [variations]

## Quick Wins (Implement First)
1. [Specific action with exact change needed]
2. [Specific action with exact change needed]

## Keyword Analysis

[Pass] Keyword in title
[Fail] Keyword missing in first 100 words - add to opening paragraph
[Pass] Keyword in 2/5 H2 headings
[Warn] Density: 0.8% (low - aim for 1-2%)

## Readability Metrics

- **Flesch Reading Ease**: XX/100 (Grade level: XX)
- **Average Sentence Length**: XX words
- **Passive Voice**: X%
- **Transition Words**: X%
- **Assessment**: [Good/Needs improvement]

## Meta Information

**Current Meta Title** (X chars): [current title]
**Suggested Meta Title** (XX chars):
`[Optimized title with keyword - 50-60 chars]`

**Current Meta Description**: [current or none]
**Suggested Meta Description** (XXX chars):
`[Compelling 150-160 char description with keyword and CTA]`

**URL Slug**:
Current: `/current-url-slug`
Suggested: `/keyword-rich-slug`

## Content Structure

- **Word Count**: XXXX words ([sufficient/too short] for this topic)
- **Heading Hierarchy**: [assessment]
- **Paragraph Length**: Average XX words [good/too long]
- **Sections**: [list main sections]

## Critical Issues

### 1. [Issue Name]
**Problem**: [Description]
**Impact**: [SEO impact]
**Fix**: [Specific instruction]

**Example**:

Current: [show current problematic text] Improved: [show corrected version]


## High Priority Recommendations

### 1. [Recommendation]
[Specific actionable instruction]

## Content Gaps

Missing subtopics to add:
- **[Subtopic 1]**: [Why it's important] (search volume: XXX)
- **[Subtopic 2]**: [Why it's important]

## Internal Linking Opportunities

- Link to: [page URL] using anchor text: "[keyword phrase]"
- Link from: [this content] to [related page]

## Featured Snippet Opportunity

[If applicable, show how to format content for featured snippet]

Example:
```markdown
## What is [topic]?

[Clear, concise 40-60 word answer]

- Key point 1
- Key point 2
- Key point 3

Competitor Insights

[If analysis was done]

  • Top ranking content averages XXXX words
  • Common topics covered: [list]
  • Content advantage: [unique angle]

Implementation Checklist

  • Update meta title and description
  • Add keyword to first paragraph
  • Fix heading structure
  • Add missing alt text (X images)
  • Add internal links (X opportunities)
  • Expand [thin section] with XXX words
  • Add FAQ section for featured snippet

Estimated Impact

Time to Implement: X hours Expected Improvement: [Moderate/Significant] ranking boost Priority: [High/Medium/Low]


## Best Practices

- **Prioritize user experience** over keyword stuffing
- **Write for humans first**, optimize for search engines second
- **Provide specific examples**, not vague advice
- **Consider search intent** behind keywords (informational, commercial, transactional)
- **Recommend content additions**, not just optimization
- **Check for E-A-T signals** (author bio, credentials, sources)
- **Suggest schema markup** where relevant (FAQ, How-To, Review)
- **Look for featured snippet opportunities** (definition boxes, lists, tables)

## Example Workflow

**User request**: "Optimize this blog post for 'best project management tools'"

**Analysis**:
1. Check keyword placement - found in title but not H1 (fix needed)
2. Calculate density - 0.5% (too low, needs 8-10 more mentions)
3. Analyze readability - Flesch score 55 (good), but sentences too long
4. Generate meta tags - create compelling meta description
5. Identify gaps - missing "pricing comparison" and "team size recommendations"
6. Find internal links - link to "project management tips" article
7. Suggest featured snippet - format comparison table
8. Provide prioritized action list

---

**Remember**: SEO is about creating valuable, well-optimized content that serves user intent better than competitors.
1---
2name: seo-optimizer
3description: Optimize content for search engines with keyword analysis, readability scoring, meta descriptions, and competitor comparison. Use this when users want to improve SEO, optimize blog posts, or analyze content for search performance.
4---
5 
6# SEO Content Optimizer
7 
8Comprehensive SEO analysis and optimization for content creators and marketers.
9 
10To optimize content for SEO, provide a detailed analysis covering keywords, readability, technical SEO, and actionable recommendations.
11 
12## Instructions
13 
14### 1. Analyze Target Keywords
15 
16Examine keyword usage and placement:
17- Identify primary keyword(s) from user input or content
18- Check keyword placement (title, H1, first 100 words, subheadings)
19- Calculate keyword density (aim for 1-2%)
20- Identify LSI keywords and semantic variations present
21- Flag keyword stuffing issues
22 
23### 2. Evaluate Content Structure
24 
25Assess the organization and hierarchy:
26- Check heading hierarchy (single H1, then multiple H2, then H3)
27- Verify keyword usage in headings
28- Evaluate heading descriptiveness
29- Check paragraph length (aim for <150 words)
30- Assess overall scanability
31 
32### 3. Readability Analysis
33 
34Calculate readability metrics:
35- Flesch Reading Ease score (aim for 60-70)
36- Grade level estimation
37- Average sentence length (aim for <20 words)
38- Passive voice percentage (minimize)
39- Transition word usage
40- Paragraph structure
41 
42### 4. Technical SEO Elements
43 
44Generate optimized meta elements:
45- **Meta Title**: 50-60 characters with primary keyword
46- **Meta Description**: 150-160 characters, compelling with keyword
47- **URL Slug**: Short, keyword-rich, hyphen-separated
48- **Image Alt Text**: Descriptive with keywords where natural
49- **Internal Linking**: Opportunities to link to related content
50- **External Links**: Quality of outbound links
51 
52### 5. Content Quality Assessment
53 
54Evaluate comprehensiveness:
55- Word count (competitive topics need 1500+ words)
56- Content depth and detail level
57- Topic coverage completeness
58- Unique value proposition
59- E-A-T signals (expertise, authority, trust)
60- Content freshness (dates, current examples)
61 
62### 6. Provide Actionable Recommendations
63 
64Prioritize improvements by impact:
65 
66**Critical (Fix Immediately)**:
67- Missing or poor meta description
68- No keyword in title or H1
69- Broken internal links
70- Keyword density too high/low
71 
72**High Priority**:
73- Poor readability score
74- Weak heading structure
75- Missing alt text on images
76- Content too thin
77 
78**Medium Priority**:
79- Could add related keywords
80- Opportunity for featured snippet
81- Could improve internal linking
82 
83Provide specific, actionable fixes with examples.
84 
85## Output Format
86 
87```markdown
88# SEO Analysis Report
89 
90## Overall Score: X/100
91 
92### Target Keywords
93- Primary: [keyword] (density: X.X%)
94- Secondary: [keyword 1], [keyword 2]
95- LSI Keywords Found: [variations]
96 
97## Quick Wins (Implement First)
981. [Specific action with exact change needed]
992. [Specific action with exact change needed]
100 
101## Keyword Analysis
102 
103[Pass] Keyword in title
104[Fail] Keyword missing in first 100 words - add to opening paragraph
105[Pass] Keyword in 2/5 H2 headings
106[Warn] Density: 0.8% (low - aim for 1-2%)
107 
108## Readability Metrics
109 
110- **Flesch Reading Ease**: XX/100 (Grade level: XX)
111- **Average Sentence Length**: XX words
112- **Passive Voice**: X%
113- **Transition Words**: X%
114- **Assessment**: [Good/Needs improvement]
115 
116## Meta Information
117 
118**Current Meta Title** (X chars): [current title]
119**Suggested Meta Title** (XX chars):
120`[Optimized title with keyword - 50-60 chars]`
121 
122**Current Meta Description**: [current or none]
123**Suggested Meta Description** (XXX chars):
124`[Compelling 150-160 char description with keyword and CTA]`
125 
126**URL Slug**:
127Current: `/current-url-slug`
128Suggested: `/keyword-rich-slug`
129 
130## Content Structure
131 
132- **Word Count**: XXXX words ([sufficient/too short] for this topic)
133- **Heading Hierarchy**: [assessment]
134- **Paragraph Length**: Average XX words [good/too long]
135- **Sections**: [list main sections]
136 
137## Critical Issues
138 
139### 1. [Issue Name]
140**Problem**: [Description]
141**Impact**: [SEO impact]
142**Fix**: [Specific instruction]
143 
144**Example**:
145```
146Current: [show current problematic text]
147Improved: [show corrected version]
148```
149 
150## High Priority Recommendations
151 
152### 1. [Recommendation]
153[Specific actionable instruction]
154 
155## Content Gaps
156 
157Missing subtopics to add:
158- **[Subtopic 1]**: [Why it's important] (search volume: XXX)
159- **[Subtopic 2]**: [Why it's important]
160 
161## Internal Linking Opportunities
162 
163- Link to: [page URL] using anchor text: "[keyword phrase]"
164- Link from: [this content] to [related page]
165 
166## Featured Snippet Opportunity
167 
168[If applicable, show how to format content for featured snippet]
169 
170Example:
171```markdown
172## What is [topic]?
173 
174[Clear, concise 40-60 word answer]
175 
176- Key point 1
177- Key point 2
178- Key point 3
179```
180 
181## Competitor Insights
182 
183[If analysis was done]
184- Top ranking content averages XXXX words
185- Common topics covered: [list]
186- Content advantage: [unique angle]
187 
188## Implementation Checklist
189 
190- [ ] Update meta title and description
191- [ ] Add keyword to first paragraph
192- [ ] Fix heading structure
193- [ ] Add missing alt text (X images)
194- [ ] Add internal links (X opportunities)
195- [ ] Expand [thin section] with XXX words
196- [ ] Add FAQ section for featured snippet
197 
198## Estimated Impact
199 
200**Time to Implement**: X hours
201**Expected Improvement**: [Moderate/Significant] ranking boost
202**Priority**: [High/Medium/Low]
203```
204 
205## Best Practices
206 
207- **Prioritize user experience** over keyword stuffing
208- **Write for humans first**, optimize for search engines second
209- **Provide specific examples**, not vague advice
210- **Consider search intent** behind keywords (informational, commercial, transactional)
211- **Recommend content additions**, not just optimization
212- **Check for E-A-T signals** (author bio, credentials, sources)
213- **Suggest schema markup** where relevant (FAQ, How-To, Review)
214- **Look for featured snippet opportunities** (definition boxes, lists, tables)
215 
216## Example Workflow
217 
218**User request**: "Optimize this blog post for 'best project management tools'"
219 
220**Analysis**:
2211. Check keyword placement - found in title but not H1 (fix needed)
2222. Calculate density - 0.5% (too low, needs 8-10 more mentions)
2233. Analyze readability - Flesch score 55 (good), but sentences too long
2244. Generate meta tags - create compelling meta description
2255. Identify gaps - missing "pricing comparison" and "team size recommendations"
2266. Find internal links - link to "project management tips" article
2277. Suggest featured snippet - format comparison table
2288. Provide prioritized action list
229 
230---
231 
232**Remember**: SEO is about creating valuable, well-optimized content that serves user intent better than competitors.
233 

Discussion

Alternatives

Also in SEO & keywordsSee all 403 in Marketing →
Agentic Browsing ReadinessAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).Marketing · MITBacklink Profile AnalysisBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.Marketing · MIT/setup-cmsConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report.Marketing · MITCore Web Vitals optimizationOptimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".Marketing · MIT