seo-content-optimizer

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.

151 stars

Best use case

seo-content-optimizer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using seo-content-optimizer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/seo-optimizer/SKILL.md --create-dirs "https://raw.githubusercontent.com/nicepkg/ai-workflow/main/workflows/marketing-pro-workflow/.claude/skills/seo-optimizer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/seo-optimizer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How seo-content-optimizer Compares

Feature / Agentseo-content-optimizerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# SEO Content Optimizer

Comprehensive SEO analysis and optimization for content creators and marketers.

When a user asks you 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 → multiple H2 → 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

```markdown
# 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

✅ Keyword in title
❌ Keyword missing in first 100 words ← Add to opening paragraph
✅ Keyword in 2/5 H2 headings
⚠️ 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]
- Your 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**: "Optimize this blog post for 'best project management tools'"

**Your 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.

Related Skills

youtube-seo-optimizer

151
from nicepkg/ai-workflow

Optimize YouTube videos for search and discovery. Generates SEO-optimized titles, descriptions, tags, hashtags, and chapters. Includes keyword research and competitor analysis. Use when publishing videos, improving discoverability, or optimizing existing content.

video-title-optimizer

151
from nicepkg/ai-workflow

Optimize video titles for maximum click-through rate (CTR) and YouTube/TikTok SEO. Generates multiple title variations balancing curiosity, keywords, and platform best practices. Use when naming videos, improving CTR, or A/B testing titles.

linkedin-post-optimizer

151
from nicepkg/ai-workflow

Professional narrative style with line breaks, hashtag strategy, and hooks in first 2 lines to avoid truncation

content-optimizer

151
from nicepkg/ai-workflow

On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability. Use when optimizing existing content or validating new content against SEO requirements.

social-media-content-repurposer

151
from nicepkg/ai-workflow

Convert content between platforms (blog to Twitter thread, article to LinkedIn post, etc.). Optimize for each platform's format, tone, and best practices. Use when user wants to adapt content for different social media platforms.

podcast-to-content-suite

151
from nicepkg/ai-workflow

Transform podcast transcripts into comprehensive content marketing suites including blog posts, social media content, newsletters, SEO-optimized articles, and timestamps. Use when user provides podcast transcripts or wants to repurpose podcast content.

email-subject-line-optimizer

151
from nicepkg/ai-workflow

A/B test subject line variations using proven copywriting frameworks. Predict open rates based on historical performance.

content-trend-researcher

151
from nicepkg/ai-workflow

Advanced content and topic research skill that analyzes trends across Google Analytics, Google Trends, Substack, Medium, Reddit, LinkedIn, X, blogs, podcasts, and YouTube to generate data-driven article outlines based on user intent analysis

content-research

151
from nicepkg/ai-workflow

Research-first content creation optimized for both human readers and AI search engines (Claude, ChatGPT, Perplexity, Gemini). Creates authentic, authoritative content that becomes the go-to citation source for AI models answering user questions. Use this skill when: - Creating content that should appear in AI search results (Perplexity, ChatGPT, Claude) - Building topical authority to become THE source AI cites for a topic - Launching a new product and need compelling, citable content - Creating blog posts, articles, social media, or press releases - Need content that references real trends, people, and recent events - Want AI-assisted content that doesn't sound AI-generated - Creating thought leadership content in any industry Triggers: "create content for", "write about", "research and write", "find experts for", "content for launch", "blog post about", "article on", "press release for", "AI search", "show up in AI", "Perplexity", "be cited by AI"

content-brief

151
from nicepkg/ai-workflow

Content brief template and creation methodology for SEO-optimized content. Use when preparing briefs for writers or planning new content pieces.

content-brief-generator

151
from nicepkg/ai-workflow

Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.

youtube-to-markdown

151
from nicepkg/ai-workflow

Use when user asks YouTube video extraction, get, fetch, transcripts, subtitles, or captions. Writes video details and transcription into structured markdown file.