Content Optimization
Tune on-page copy for SEO—length, H2 keyword placement, density, and rich elements—without slipping into stuffing.
Overview
Content-optimization is an agent skill most often used in Launch (also Grow) that guides on-page SEO tuning—length, H2 keywords, density, tables, lists, and multimedia—without keyword stuffing.
Install
npx skills add https://github.com/kostja94/marketing-skills --skill content-optimizationWhat is this skill?
- Covers generic content length strategy and points to article-content for article-specific word-count targets
- H2 keyword placement, quantity, and variation without manipulation
- Keyword density vs stuffing with natural-use guidance
- Multimedia, tables, lists, and video for structure and snippet eligibility
- Pairs with heading-structure, content-strategy, featured-snippet, and keyword-research
- version 1.2.1 in skill metadata
Adoption & trust: 891 installs on skills.sh; 586 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have draft content and keywords but no clear rules for length, headings, density, or rich formatting that ranks without triggering spam signals.
Who is it for?
Indie founders or marketers rewriting blog posts, landing pages, or docs for organic search after keyword research is done.
Skip if: Choosing target keywords from scratch (use keyword-research) or defining site-wide heading templates only (use heading-structure).
When should I use this skill?
User wants SEO content optimization—word count, H2 keywords, density, tables, lists—or says content length, keyword stuffing, or content structure; use keyword-research for keywords first.
What do I get? / Deliverables
You get a structured optimization pass aligned to your keywords and content type, with natural keyword use and media structure—then refine headings via heading-structure or snippets via featured-snippet as needed.
- On-page optimization recommendations for length, headings, density, and rich elements
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Launch because the skill’s triggers and outputs are on-page SEO optimization for published or soon-to-publish pages. Subphase seo matches word count, heading keywords, density, tables, lists, and multimedia guidance tied to search visibility.
Where it fits
Before publishing a pricing page, align H2s and body length with primary keywords without over-stuffing.
Refresh a top traffic post with tables and lists to capture snippet queries.
Optimize public docs pages that double as SEO landing content.
How it compares
On-page execution guide after strategy— not a keyword discovery tool or a full content calendar planner.
Common Questions / FAQ
Who is content-optimization for?
Solo builders and small teams shipping content-heavy sites who need repeatable on-page SEO checks on real drafts.
When should I use content-optimization?
At launch when polishing pages for search, during grow when refreshing old posts, and whenever you mention word count, H2 keywords, density, tables, or bullet structure.
Is content-optimization safe to install?
It is procedural SEO guidance with no built-in network calls in the skill itself; review the Security Audits panel on this page before installing from any marketplace.
Workflow Chain
Requires first: keyword research
Then invoke: heading structure, featured snippet
SKILL.md
READMESKILL.md - Content Optimization
# 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 **Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for target keywords and content type. 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** —