home / skills / madappgang / claude-code / content-optimizer

content-optimizer skill

safe

This skill helps optimize on-page SEO for existing or new content by refining keyword density, meta tags, headings, and readability.

npx playbooks add skill madappgang/claude-code --skill content-optimizer

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

2.7 KB

---
plugin: seo
updated: 2026-01-20
name: content-optimizer
description: 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.
---
plugin: seo
updated: 2026-01-20

# Content Optimizer

## When to Use

- Optimizing existing content for better rankings
- Validating new content against SEO requirements
- Checking keyword density and placement
- Improving readability scores
- Creating meta tags

## Keyword Density

**Target:** 1-2% for primary keyword

**Calculation:**
```
Density = (Keyword Count / Total Words) x 100
```

**Placement Priorities:**
1. Title/H1 (required)
2. First 100 words (required)
3. At least one H2 (recommended)
4. Conclusion (recommended)
5. Distributed in body (natural)

**Warning Signs:**
- >3% = Keyword stuffing risk
- <0.5% = Under-optimized
- Exact match every paragraph = Unnatural

## Meta Tag Optimization

### Title Tag
- Length: 50-60 characters
- Keyword: Near the beginning
- Format: `{Keyword} - {Benefit} | {Brand}`
- Unique per page

### Meta Description
- Length: 150-160 characters
- Keyword: Include naturally
- CTA: End with action verb
- Unique per page

### URL Slug
- Short: 3-5 words
- Keyword: Include primary
- Readable: Use hyphens
- Lowercase only

## Heading Structure

**Valid Hierarchy:**
```
H1: Page Title (exactly 1)
+-- H2: Main Section
|   +-- H3: Subsection
|   +-- H3: Subsection
+-- H2: Main Section
|   +-- H3: Subsection
+-- H2: Conclusion
```

**Common Errors:**
- Multiple H1 tags
- Skipping levels (H1 -> H3)
- Using headings for styling only
- No keyword in H1

## Readability Optimization

**Flesch Reading Ease Target: 60-70**

| Score | Level | Audience |
|-------|-------|----------|
| 90-100 | Very Easy | 5th grade |
| 80-89 | Easy | 6th grade |
| 70-79 | Fairly Easy | 7th grade |
| 60-69 | Standard | 8th-9th grade |
| 50-59 | Fairly Difficult | 10th-12th grade |
| 30-49 | Difficult | College |
| 0-29 | Very Difficult | College graduate |

**Improvement Techniques:**
- Shorten sentences (<20 words avg)
- Shorten paragraphs (2-3 sentences)
- Replace jargon with plain language
- Use active voice
- Add subheadings every 200-300 words
- Use bullet points for lists

## Optimization Checklist

Use this checklist when optimizing content:

- [ ] Primary keyword in title/H1
- [ ] Primary keyword in first 100 words
- [ ] Keyword density 1-2%
- [ ] Meta title 50-60 characters
- [ ] Meta description 150-160 characters with CTA
- [ ] Heading hierarchy valid (H1 -> H2 -> H3)
- [ ] At least 3 internal links
- [ ] At least 1 external authoritative link
- [ ] Flesch score 60-70
- [ ] No paragraphs > 3 sentences
- [ ] Subheadings every 200-300 words

Overview

This skill provides practical on-page SEO optimization for content, focusing on keyword density, meta tags, heading structure, and readability. It helps optimize existing pages or validate new drafts against actionable SEO requirements. The goal is measurable improvements in search relevance and user experience.

How this skill works

The skill analyzes text to calculate keyword density, checks placement priorities (title, first 100 words, headings, conclusion), and flags stuffing or underuse. It evaluates meta title, meta description, and URL slug against length and formatting guidelines. It inspects heading hierarchy and readability (Flesch Reading Ease) and produces a checklist of fixes and priorities.

When to use it

Optimizing existing webpages to improve rankings and CTR
Validating new content before publishing to meet SEO standards
Checking keyword density and natural placement across the page
Creating or refining meta title, description, and URL slugs
Improving readability and structure for broader audience comprehension

Best practices

Aim for 1–2% keyword density for the primary keyword; avoid >3% to prevent stuffing
Place the primary keyword in the H1/title and within the first 100 words
Keep meta title 50–60 characters and meta description 150–160 characters with a clear CTA
Follow valid heading hierarchy (single H1, nested H2→H3) and include the keyword in H1
Target a Flesch Reading Ease score of 60–70 by shortening sentences and paragraphs

Example use cases

Run a pre-publish audit to ensure primary keyword is in title, first 100 words, and an H2
Revise meta tags and URL slug after content updates to improve CTR in SERPs
Adjust sentence length and paragraph structure to raise Flesch score into the 60–70 range
Detect keyword stuffing or gaps and suggest redistribution across headings and conclusion
Generate an optimization checklist with internal/external link targets and heading fixes

FAQ

What is the ideal keyword density?

Target 1–2% for the primary keyword; below 0.5% is under-optimized and above 3% risks keyword stuffing.

How long should meta descriptions be?

Keep meta descriptions between 150–160 characters and include a natural keyword plus a call to action.