Skip to content

secondsky/claude-skills / plugins/seo-optimizer/skills/seo-optimizer

seo-optimizer

Verified

SEO optimization with keyword analysis, readability assessment, technical validation, content quality. Use for search rankings, blog posts, content audits, or encountering keyword density, readability scores, meta tags, schema markup errors.

FileKindSize
SKILL.mdskill md6.3 KB
references/analysis-framework.mdmarkdown11.2 KB
references/output-templates.mdmarkdown17.4 KB

references/output-templates.md

View on GitHub
# SEO Optimizer Output Templates

## Complete SEO Analysis Report Template

```markdown
# SEO Analysis Report

**Date**: [YYYY-MM-DD]
**Content**: [URL or Title]
**Primary Keyword**: [keyword]

---

## Overall Score: X/100

### Score Breakdown
- Keywords: XX/25
- Readability: XX/25
- Technical: XX/25
- Content Quality: XX/25

---

## Quick Wins (Implement First) πŸš€

1. **[Specific action with exact change needed]**
   - Current: [show current state]
   - Fix: [exact text to use]
   - Impact: [High/Medium/Low]
   - Time: [X minutes]

2. **[Second quick win]**
   - Current: [show current state]
   - Fix: [exact text to use]
   - Impact: [High/Medium/Low]
   - Time: [X minutes]

3. **[Third quick win]**
   - Current: [show current state]
   - Fix: [exact text to use]
   - Impact: [High/Medium/Low]
   - Time: [X minutes]

---

## Keyword Analysis

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

### Placement Check
βœ… Keyword in title
❌ Keyword missing in first 100 words ← **Add to opening paragraph**
βœ… Keyword in 2/5 H2 headings
⚠️ Keyword in URL but could be more prominent
βœ… Keyword in meta description

### Density Analysis
- **Current Density**: X.X%
- **Target Range**: 1-2%
- **Status**: [Too low/Optimal/Too high]
- **Recommendation**: [Add/Remove] X mentions throughout content

### Suggested Keyword Placements

**Add keyword naturally in these sections:**
1. Opening paragraph (after sentence 2)
2. Before "Benefits" H2 heading
3. In conclusion paragraph

**Example insertion:**
Current: "Managing projects efficiently requires the right approach."
Improved: "Managing projects efficiently with **project management tools** requires the right approach."

---

## Readability Metrics

### Overall Assessment: [Good/Needs Improvement/Poor]

| Metric | Current | Target | Status |
|--------|---------|--------|--------|
| Flesch Reading Ease | XX | 60-70 | [βœ…/⚠️/❌] |
| Grade Level | X | 7-9 | [βœ…/⚠️/❌] |
| Avg Sentence Length | XX words | <20 | [βœ…/⚠️/❌] |
| Passive Voice | X% | <10% | [βœ…/⚠️/❌] |
| Transition Words | X% | >30% | [βœ…/⚠️/❌] |

### Detailed Findings

**Flesch Reading Ease: XX/100** (Grade level: XX)
- Interpretation: [Very Easy/Easy/Standard/Difficult]
- Assessment: [Good for target audience / Needs simplification]

**Sentence Length Issues:**
Found X sentences over 30 words:
1. "The comprehensive project management software..." (35 words) β†’ Split into 2 sentences
2. "When teams collaborate effectively..." (32 words) β†’ Simplify or break up

**Passive Voice Examples:**
1. "The project was completed by the team" β†’ "The team completed the project"
2. "Tasks are assigned automatically" β†’ "The system assigns tasks automatically"

**Add Transition Words:**
Paragraph 3: No transitions β†’ Add "Furthermore," or "Additionally,"
Paragraph 5: Abrupt shift β†’ Add "However," to show contrast

---

## Meta Information

### Meta Title

**Current** (X chars): [current title or "Missing"]

**Issues:**
- [Too short/long, missing keyword, not compelling]

**Suggested** (XX chars):
```
[Optimized Title with Keyword - 50-60 characters]
```

**Why this works:**
- Includes primary keyword at start
- Under 60 characters (won't get cut off)
- Has compelling benefit/number
- Includes year for freshness

---

### Meta Description

**Current** (X chars): [current description or "Missing"]

**Issues:**
- [Missing keyword, no CTA, too short/long, not compelling]

**Suggested** (XXX chars):
```
[Compelling description that includes primary keyword and clear value proposition.
Includes call-to-action. 150-160 characters ideal.]
```

**Formula used:** Value prop + Keyword + Benefit + CTA

---

### URL Slug

**Current**: `/current-url-slug-here`

**Issues:**
- [Too long, missing keyword, special characters, not descriptive]

**Suggested**: `/keyword-rich-short-slug`

**Changes:**
- Shortened from X to Y characters
- Added primary keyword
- Removed stop words (a, the, for)
- Used hyphens for separation

---

## Content Structure

### Overview
- **Word Count**: XXXX words
- **Assessment**: [Too short/Adequate/Comprehensive] for this topic
- **Recommendation**: [Add XXX words / Good length / Could trim]

### Heading Analysis

**Current Structure:**
```
H1: [Main title]
  H2: [Section 1] βœ…
    H3: [Subsection] βœ…
  H2: [Section 2] βœ…
  H3: [Subsection] ⚠️ Should be under H2
  H2: [Section 3] βœ…
```

**Issues Found:**
1. [H3 not nested under H2 - breaks hierarchy]
2. [Missing H2 for important topic]
3. [H2 doesn't include keyword variation]

**Recommended Changes:**
1. Add H2 "Benefits of [Keyword]" before section 3
2. Move "Implementation" H3 under "How to Use" H2
3. Change "Getting Started" to "How to Get Started with [Keyword]"

### Paragraph Analysis

**Average paragraph length**: XX words ([Good/Too long])

**Paragraphs needing splits** (over 150 words):
1. Paragraph 2 (180 words) β†’ Split after sentence 4
2. Paragraph 5 (165 words) β†’ Split after sentence 3

**Improvement example:**
Current (180 words): [Long paragraph...]

Split into:
Part 1 (90 words): [First half...]
Part 2 (90 words): [Second half...]

---

## Critical Issues 🚨

### 1. Missing Primary Keyword in H1

**Problem**: H1 is "Ultimate Guide" but doesn't include target keyword "project management tools"

**Impact**: Major ranking factor - H1 should contain primary keyword

**Fix**: Change H1 to "Ultimate Guide to Project Management Tools"

**Example:**
```markdown
Current: # Ultimate Guide
Improved: # Ultimate Guide to Project Management Tools
```

---

### 2. No Meta Description

**Problem**: Page has no meta description, Google will generate one automatically

**Impact**: Missed opportunity to control what searchers see in results

**Fix**: Add meta description using suggested template above

---

### 3. Images Missing Alt Text

**Problem**: 5 of 8 images have empty alt attributes

**Impact**: Accessibility issue + missed keyword opportunity

**Fix**: Add descriptive alt text to each image

**Examples:**
- Image 1: `alt="Project management dashboard showing task progress"`
- Image 2: `alt="Team using collaboration tools for project planning"`
- Image 3: `alt="Gantt chart example for project timeline management"`

---

## High Priority Recommendations ⚠️

### 1. Improve Readability Score

**Current**: Flesch score 52 (Fairly Difficult)
**Target**: 60-70 (Standard)

**Actions:**
1. Shorten 8 long sentences (>30 words)
2. Convert 5 passive voice sentences to active
3. Break up 3 long paragraphs
4. Add transition words to 6 paragraphs

**Estimated improvement**: +12 points β†’ Score of 64

---

### 2. Add Internal Links

**Found 0 internal links** - add at least 3-5

**Opportunities:**
1. Link "team collaboration" to `/team-collaboration-guide`
   - Anchor text: "effective team collaboration strategies"
   - Location: Paragraph 3

2. Link "task management" to `/task-management-tips`
   - Anchor text: "best task management practices"
   - Location: Paragraph 5

3. Link "productivity" to `/productivity-tools`
   - Anchor text: "productivity tools for teams"
   - Location: Paragraph 7

---

### 3. Strengthen Opening

**Current opening** (first 100 words): Doesn't include primary keyword

**Suggested rewrite:**
```markdown
Current:
"Managing complex initiatives requires organization and the right approach.
Many teams struggle with coordination and tracking progress effectively."

Improved:
"Choosing the right project management tools can transform how your team
collaborates and delivers results. With hundreds of project management tools
available, finding the perfect fit for your team's workflow is crucial.
This guide covers the top project management tools for 2024, helping you
make an informed decision."
```

**Changes:**
- Added primary keyword 3 times naturally
- Clearer value proposition
- Better hook for readers

---

## Content Gaps

### Missing Subtopics to Add

Based on competitor analysis, add these sections:

**1. Pricing Comparison** (Search volume: 2.4K/month)
- Why it matters: Users need budget information
- Suggested length: 300-400 words
- Include: Pricing table, free tier info, value analysis

**2. Team Size Recommendations** (Search volume: 880/month)
- Why it matters: Helps users find right fit
- Suggested length: 200-300 words
- Include: Small teams (2-10), Medium (10-50), Large (50+)

**3. Integration Capabilities** (Search volume: 1.2K/month)
- Why it matters: Technical requirement for many users
- Suggested length: 400-500 words
- Include: Slack, Google Workspace, Microsoft 365 integrations

**4. Mobile App Comparison** (Search volume: 650/month)
- Why it matters: Growing mobile usage
- Suggested length: 250-300 words
- Include: iOS/Android availability, features, ratings

### Competitor Insights

**Top ranking content** (analyzed top 3):
- Average word count: 2,800 words (you: 1,400)
- Common topics: Pricing (3/3), Integrations (3/3), Mobile apps (2/3)
- Unique features: Comparison tables (3/3), Video demos (2/3)

**Your advantage opportunity:**
- Add live pricing comparison table
- Include more screenshots
- Add FAQ section for featured snippet
- More current examples (competitors use 2022-2023 data)

---

## Internal Linking Opportunities

### Recommended Links to Add

**Within this content:**

1. **Paragraph 3** - Link to related content
   - Text: "team collaboration strategies"
   - Link to: `/blog/team-collaboration-best-practices`
   - Context: When discussing collaboration features

2. **Paragraph 6** - Link to comparison guide
   - Text: "compare the top project management platforms"
   - Link to: `/comparisons/project-management-tools`
   - Context: When introducing tool options

3. **Paragraph 9** - Link to getting started guide
   - Text: "how to implement project management software"
   - Link to: `/guides/implementing-pm-software`
   - Context: In implementation section

4. **Conclusion** - Link to resource hub
   - Text: "project management resources"
   - Link to: `/resources/project-management`
   - Context: Final CTA

**Pages that should link here:**

5. `/blog/team-productivity` should link here
   - Suggested anchor: "choosing project management tools"
   - Why: Relevant context about productivity tools

6. `/guides/remote-work-setup` should link here
   - Suggested anchor: "project management tools for remote teams"
   - Why: PM tools essential for remote work

---

## Featured Snippet Opportunity

**Query**: "What are the best project management tools?"

**Current format**: Long prose paragraph

**Recommended format**: Definition + list

```markdown
## What Are the Best Project Management Tools?

The best project management tools help teams plan, track, and collaborate
on projects efficiently. Top options include Asana, Monday.com, and Trello.

**Top 5 Project Management Tools:**

1. **Asana** - Best for team collaboration and workflow automation
2. **Monday.com** - Best for visual project tracking and customization
3. **Trello** - Best for simple kanban-style project management
4. **Jira** - Best for software development teams and agile workflows
5. **ClickUp** - Best all-in-one solution for complex project needs

Each tool offers unique features suited to different team sizes and industries.
```

**Why this format works:**
- Answers question directly in first paragraph
- Numbered list ideal for featured snippets
- Each item has descriptor (helps Google understand)
- Under 60 words for featured snippet character limit

---

## Schema Markup Recommendations

### 1. FAQ Schema (High Priority)

Add FAQ section and implement FAQ schema for featured snippets:

```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is the best project management tool?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The best project management tool depends on your team's needs..."
      }
    },
    {
      "@type": "Question",
      "name": "How much do project management tools cost?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Project management tools range from free plans to $30+ per user per month..."
      }
    }
  ]
}
```

### 2. Article Schema

```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Best Project Management Tools 2024",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-15",
  "publisher": {
    "@type": "Organization",
    "name": "Your Brand"
  }
}
```

---

## Implementation Checklist

### Immediate Actions (Critical)
- [ ] Add primary keyword to H1
- [ ] Create meta description (use template above)
- [ ] Add keyword to first 100 words
- [ ] Fix 5 images missing alt text
- [ ] Add meta title with keyword

**Time estimate**: 30 minutes
**Expected impact**: High - fixes major SEO gaps

### High Priority (This Week)
- [ ] Split 3 long paragraphs
- [ ] Shorten 8 long sentences
- [ ] Add 5 internal links (use URLs above)
- [ ] Improve heading hierarchy
- [ ] Add transition words to 6 paragraphs

**Time estimate**: 2 hours
**Expected impact**: Medium-High - improves readability

### Medium Priority (This Month)
- [ ] Add "Pricing Comparison" section (300 words)
- [ ] Add "Team Size Recommendations" section (250 words)
- [ ] Add "Integration Capabilities" section (400 words)
- [ ] Create FAQ section (5-8 questions)
- [ ] Add comparison table

**Time estimate**: 4-5 hours
**Expected impact**: Medium - fills content gaps

### Enhancement (Next Quarter)
- [ ] Implement FAQ schema markup
- [ ] Add video demonstration
- [ ] Create downloadable comparison PDF
- [ ] Add user testimonials
- [ ] Update with latest tool features

**Time estimate**: 8-10 hours
**Expected impact**: Medium - competitive advantages

---

## Estimated Impact

**Overall Assessment**:
- **Time to Implement Critical + High Priority**: ~2.5 hours
- **Expected Ranking Improvement**: Moderate to significant
- **Timeframe**: 4-8 weeks after implementation
- **Priority Level**: High

**Expected Outcomes**:
- Better keyword rankings (primary keyword: +5-15 positions estimated)
- Improved CTR from search results (better meta tags)
- Lower bounce rate (improved readability)
- More internal traffic (added internal links)
- Featured snippet potential (FAQ format)

---

## Example Workflow

### User Request
"Optimize this blog post for 'best project management tools'"

### Analysis Process

**Step 1: Keyword Analysis** (5 min)
- Extract primary keyword: "project management tools"
- Check placement β†’ Found in title but not H1 ❌
- Calculate density β†’ 0.8% (too low) ⚠️
- Identify LSI keywords β†’ "task management", "collaboration", "workflow"

**Step 2: Readability Check** (3 min)
- Calculate Flesch score β†’ 52 (too difficult) ⚠️
- Count long sentences β†’ 8 over 30 words ❌
- Find passive voice β†’ 12% (too high) ⚠️
- Assess paragraph length β†’ 3 over 150 words ⚠️

**Step 3: Technical SEO** (5 min)
- Meta title β†’ 72 characters (too long) ❌
- Meta description β†’ Missing ❌
- URL slug β†’ `/blog/post-123` (not descriptive) ❌
- Images β†’ 5/8 missing alt text ❌

**Step 4: Content Quality** (5 min)
- Word count β†’ 1,400 (adequate but could be better)
- Competitor average β†’ 2,800 words (gap found) ⚠️
- Missing topics β†’ Pricing, integrations, mobile apps
- E-A-T signals β†’ Author bio present βœ…

**Step 5: Prioritize Fixes** (2 min)
- Critical: Meta tags, H1 keyword, alt text
- High: Readability improvements, internal links
- Medium: Add missing topics, FAQ section

**Step 6: Generate Report** (5 min)
- Create formatted output with all findings
- Provide specific before/after examples
- Include implementation checklist
- Estimate impact and timeline

**Total analysis time**: ~25 minutes

---

## Additional Tips

### When Analyzing Content

1. **Always provide specific examples**
   - Not: "Improve your headings"
   - But: "Change H2 from 'Getting Started' to 'How to Get Started with Project Management Tools'"

2. **Show before/after comparisons**
   ```
   Current: "The tool is used by teams."
   Improved: "Teams use the tool to manage projects efficiently."
   ```

3. **Explain the "why"**
   - "Add keyword to H1 because Google weighs H1 content heavily for ranking"

4. **Estimate impact and effort**
   - Impact: High/Medium/Low
   - Time: X minutes/hours
   - Priority: Critical/High/Medium

5. **Consider search intent**
   - Informational: User wants to learn
   - Commercial: User comparing options
   - Transactional: User ready to buy
   - Match content to intent

### Red Flags to Watch For

- Keyword density >3% (stuffing)
- Multiple H1 tags (confuses search engines)
- Thin content (<300 words on important topics)
- No internal links (poor site architecture)
- Broken links (hurts credibility)
- Outdated information (content freshness matters)
- Missing author/credentials (E-A-T signals)
- No mobile optimization (mobile-first indexing)

### Quick Assessment Checklist

```markdown
[ ] Primary keyword in title, H1, first 100 words
[ ] Meta title 50-60 characters with keyword
[ ] Meta description 150-160 characters with CTA
[ ] URL slug short and keyword-rich
[ ] Images have descriptive alt text
[ ] Readability score 60-70
[ ] Word count appropriate for topic
[ ] Heading hierarchy correct (single H1 β†’ H2 β†’ H3)
[ ] 3-5 internal links to related content
[ ] Content answers user search intent
[ ] E-A-T signals present (author, sources)
[ ] Content includes current year/data
```

If 10+ checked: Good optimization
If 7-9 checked: Needs improvement
If <7 checked: Requires significant work
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall