Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
kostja94 avatar

Content Optimization

  • 927 installs
  • 787 repo stars
  • Updated June 9, 2026
  • kostja94/marketing-skills

content-optimization is an SEO skill that improves on-page factors such as keyword placement, content length, heading keywords, and structure so developers and marketers can raise article and landing page rankings.

About

content-optimization is version 1.2.1 of an on-page SEO guidance skill in kostja94/marketing-skills. It walks agents through word count targets, H2 keyword placement, keyword density versus stuffing, multimedia usage, tables, and bullet lists while complementing heading-structure and content-strategy skills. Developers reach for content-optimization when a draft article or landing page needs search-focused tuning after keywords are chosen elsewhere via keyword-research. Triggers include mentions of content length, keyword density, H2 keywords, tables, bullet points, or content structure during SEO edits.

  • Guides word count targets by content type
  • Optimizes H2 keyword placement, quantity and variation
  • Balances keyword density while avoiding stuffing
  • Recommends strategic use of multimedia, tables, lists and images
  • Reads project-context.md for target keywords on first run

Content Optimization by the numbers

  • 927 all-time installs (skills.sh)
  • +5 installs in the week ending Jul 29, 2026 (Skillselion tracking)
  • Ranked #466 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kostja94/marketing-skills --skill content-optimization

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs927
repo stars787
Security audit2 / 3 scanners passed
Last updatedJune 9, 2026
Repositorykostja94/marketing-skills

How do you optimize on-page SEO content structure and keywords?

Improve on-page SEO factors like keyword placement, content length, and structure so their articles and landing pages rank higher.

Who is it for?

Developers publishing blog posts or marketing pages who already have target keywords and need on-page structure and density guidance.

Skip if: Teams needing keyword discovery, technical SEO audits, or local Google Business Profile setup instead of on-page copy tuning.

When should I use this skill?

User mentions content length, H2 keywords, keyword density, keyword stuffing, tables, bullet points, or on-page content structure for SEO.

What you get

SEO-tuned article or landing page with improved headings, keyword placement, and content structure

  • optimized article copy
  • structured landing page content

By the numbers

  • Skill version 1.2.1 in kostja94/marketing-skills
  • Complements heading-structure and content-strategy skills in the same repo

Files

SKILL.mdMarkdownGitHub ↗

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 typeWord countNotes
News / announcements300–600Time-sensitive; concise
Standard articles / how-tos1,000–1,500Single topic; actionable
Listicles / guides1,200–2,000"Top 10," "Best X"
Pillar / cornerstone2,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

PracticePurpose
Descriptive H2sSearch engines understand context; users scan
Answer-firstPlace direct answer in first 40–50 words after H2 for Featured Snippets; see featured-snippet
Keyword variationUse related terms; avoid repeating exact phrase in every H2
Logical flowH2s outline the article; support topical authority

---

Keyword Density vs Keyword Stuffing

Definitions

TermMeaning
Keyword density(Keyword count / Total words) × 100; a metric, not a ranking factor
Keyword stuffingExcessive, 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

PracticePurpose
Alt, file names, captionsSee image-optimization for full image SEO (alt, format, responsive, lazy loading, image sitemap, LCP, captions for Featured Snippets)
Original over stockUnique 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

PracticePurpose
Embed + metadataVideoObject schema, video sitemap, thumbnail; see video-optimization
YouTubeGoogle prioritizes YouTube in search; GEO citation; see youtube-seo, generative-engine-optimization
Featured Snippet (video)Video schema; timestamps/chapters; see featured-snippet

Tables

  • Use for: Comparisons, stats, specs, "X vs Y"
  • Semantic HTML: <table>, <thead>, <tbody>, clear column headers
  • Featured Snippets: ~6% of snippets are tables; optimize headers with target keywords. See featured-snippet
  • Mobile: Responsive; avoid horizontal scroll when possible
  • Data quality: No empty cells; consistent units; accurate, current data

Lists: Ordered vs Unordered

TypeUse caseSEO / Snippet
Ordered (`<ol>`)Steps, rankings, sequences, "Top 10"List snippets (~19% of Featured Snippets); how-to; see featured-snippet
Unordered (`<ul>`)Non-sequential items, features, optionsBullet snippets; definitions, options

Best practices:

  • Use semantic <ol> and <ul>; avoid divs styled as lists
  • Answer-first: For snippet targets, put the direct answer in the first 40–50 words after the heading
  • Concise items: List items should be scannable; expand in body if needed
  • Logical order: Ordered lists = sequence matters; unordered = no sequence

GEO / AI Citation

Answer-first (direct answer in first 40–60 words after H2) supports both Featured Snippets and GEO. For article-level GEO (TL;DR, Key Takeaways, QAE pattern), see article-content and generative-engine-optimization. For Featured Snippet formats and optimization, see featured-snippet.

---

Content Audit Checklist

For article content audit (hook, QAE, product connection, CTA, references, gaps), see article-content. This skill covers generic content optimization (H2 keywords, multimedia, keyword density).

---

Output Format

  • Word count recommendation by content type
  • H2 outline with keyword placement
  • Keyword density check (avoid stuffing)
  • Structure (tables, lists) for Featured Snippet opportunity; see featured-snippet
  • Multimedia checklist (images per image-optimization; tables, lists)

Related Skills

  • heading-structure: H1–H6 hierarchy; H2 keyword placement
  • content-strategy: Topic clusters, pillar + cluster
  • keyword-research: Target keywords inform placement
  • featured-snippet: Snippet formats, structure; answer-first
  • howto-section-generator: How-to step sections; <ol> lists; HowTo vs FAQ
  • eeat-signals: E-E-A-T; original images, trust
  • image-optimization: Alt, captions, format, LCP, responsive, image sitemap
  • video-optimization: Video SEO; VideoObject; video sitemap
  • competitor-research: Competitor length and structure as reference
  • article-content: Article word count by type; Content Audit Checklist; article body creation

Related skills

How it compares

Use content-optimization for on-page copy tuning after keywords exist; pair with keyword-research when search terms are still undefined.

FAQ

What on-page factors does content-optimization cover?

content-optimization covers word count, heading keywords (especially H2), keyword density versus stuffing, multimedia placement, tables, and bullet lists. The skill focuses on on-page structure and copy signals that help articles and landing pages rank.

Should I use content-optimization for keyword research?

content-optimization assumes keywords are already chosen and tunes on-page placement and structure. For keyword discovery, the readme directs agents to the separate keyword-research skill in the same marketing-skills repo.

Is Content Optimization safe to install?

skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Marketing & SEOseocontent

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.