content-optimization

Files (1)

• SKILL.md

SKILL.md (first lines)

# SEO Content: Content Optimization

Guides on-page content optimization: word count, heading keywords, keyword density vs stuffing, multimedia, tables, and lists. Complements **heading-structure** (structure) and **content-strategy** (planning).

**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Scope

- **Word count**: For articles, see **article-content** (word count by type). This skill covers generic content length strategy.
- **H2 keywords**: Placement, quantity, variation
- **Keyword density vs stuffing**: Natural use; avoid manipulation
- **Multimedia**: Images, tables, lists, video for structure and Featured Snippets. See **featured-snippet** for snippet-specific optimization; **video-optimization** for video SEO.

## Initial Assessment

**Project context:** Read root `contextus.md` when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify:
1. **Content type**: Article, guide, listicle, pillar, news
2. **Target keyword**: Primary and secondary
3. **Competitors**: Top 10 average length and structure — see **competitor-research**

---

## Word Count

**Google does not rank by word count.** Length should match search intent and topic depth. A 1,000-word post that satisfies intent can outrank a 3,000-word thin piece.

### Reference Ranges by Content Type

For **article** word count by type (news, how-to, listicle, pillar, etc.), see **article-content**. Generic ranges:

| Content type | Word count | Notes |
|--------------|-------------|-------|
| **News / announcements** | 300–600 | Time-sensitive; concise |
| **Standard articles / how-tos** | 1,000–1,500 | Single topic; actionable |
| **Listicles / guides** | 1,200–2,000 | "Top 10," "Best X" |
| **Pillar / cornerstone** | 2,000–3,500+ | Comprehensive; cluster hub |

### Strategy

1. **Analyze top 10** for target keyword — average length and depth
2. **Match intent** — informational often needs ~40% longer than transactional
3. **Value over padding** — each section must add genuine value; avoid fluff
4. **Comprehensive coverage** — answer the query and related questions

---

## H2 Heading Keywords

### Placement

- **Primary keyword**: Include naturally in at least one H2 when relevant
- **Related keywords**: Use LSI and long-tail in other H2s for topical coverage
- **Avoid stuffing**: Headings must stay clear and readable; organic placement only

### Quantity

- **No strict limit** — one H2 per major section; structure follows content
- **Typical article**: 4–8 H2s; pillar: 8–15+ H2s
- **Hierarchy**: H1 → H2 (major sections) → H3 (subsections); don't skip levels

### Best Practices

| Practice | Purpose |
|----------|---------|
| **Descriptive H2s** | Search engines understand context; users scan |
| **Answer-first** | Place direct answer in first 40–50 words after H2 for Featured Snippets; see **featured-snippet** |
| **Keyword variation** | Use related terms; avoid repeating exact phrase in every H2 |
| **Logical flow** | H2s outline the article; support topical authority |

---

## Keyword Density vs Keyword Stuffing

### Definitions

| Term | Meaning |
|------|---------|
| **Keyword density** | (Keyword count / Total words) × 100; a metric, not a ranking factor |
| **Keyword stuffing** | Excessive, unnatural repetition to manipulate rankings; black-hat |

### Current Guidance

- **Keyword density is not a direct ranking factor** — Google has stated since 2011 that repetition alone doesn't improve rankings
- **Reference range**: 0.5%–1.5% for most content; some sources cite up to 2.5%
- **Use density mainly to avoid stuffing** — if density exceeds ~2–3% and reads unnaturally, reduce
- **Prioritize natural placement**: title, H1, first 100 words, 1–2 H2s, body; avoid forced repetition

### How to Avoid Stuffing

- Write for users first; keywords should fit naturally
- Use synonyms, related terms, and question phrasing
- If a sentence sounds awkward with the keyword, rewrite
- Monitor: if every paragraph repeats the exact phrase, simplify

---

## Multimedia: Images, Tables, Lists

### Images

| Practice | Purpose |
|----------|---------|
| **Alt, file names, captions** | See **image-optimization** for full image SEO (alt, format, responsive, lazy loading, image sitemap, LCP, captions for Featured Snippets) |
| **Original over stock** | Unique images signal E-E-A-T — see **eeat-signals** |

**Content placement**: Put images near relevant text; captions support snippet thumbnails. See **image-optimization** for captions; **featured-snippet** for snippet context.

### Video

| Practice | Purpose |
|----------|---------|
| **Embed + metadata** | VideoObject schema, video sitemap, thumbnail; see **video-optimization** |
| **YouTube** | Google prioritizes YouTube in search; GEO citation; see **youtube-seo**, **generative-engine-optimization** |
| **Featured Snippet (video)** | Video schema; timestamps/chapters; see **featured-snippet** |

### Tables

From kostja94/marketing-skills, MIT.

More from kostja94/marketing-skills