MCPInstall

content-optimization

When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists. Also use when the user mentions "content length," "word count," "keyword stuffing," "H2 keywords," "keyword density," "tables," "bullet points," or "content structure." For keywords, use keyword-research.

Installs
1.3K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/kostja94/marketing-skills --skill content-optimization
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads content-optimization automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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 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

FAQ

What does the content-optimization skill do?

When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists. Also use when the user mentions "content length," "word count," "keyword stuffing," "H2 keywords," "keyword density," "tables," "bullet points," or "content structure." For keywords, use keyword-research.

How do I install content-optimization?

Run npx skills add https://github.com/kostja94/marketing-skills --skill content-optimization in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/content-optimization/ (personal) or .claude/skills/content-optimization/ (project).

Which AI agents can use content-optimization?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is content-optimization safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains content-optimization?

It is published by kostja94 in kostja94/marketing-skills. It has 1,278 recorded installs.

More from kostja94/marketing-skills

View all →

copywriting

kostja94/marketing-skills

When the user wants to write or optimize short-form marketing copy—headlines, CTAs, ad copy, landing page copy, email copy. Also use when the user mentions "copywriting," "headline," "CTA copy," "ad copy," "landing page copy," "sales copy," "conversion copy," "PAS," "AIDA," "BAB," "copy formula," or "differentiation." For long-form article bodies (blog posts, guides), use article-content.

Marketing & SEO3.9K installs

linkedin-posts

kostja94/marketing-skills

When the user wants to create LinkedIn post copy or optimize for LinkedIn. Also use when the user mentions "LinkedIn post," "LinkedIn article," "professional post," "post to LinkedIn," "LinkedIn content," "LinkedIn copy," "B2B LinkedIn," "LinkedIn engagement," "LinkedIn feed," "share box," "document post," "poll," "Newsletter," "reshare," or "LinkedIn marketing." For LinkedIn ads, use linkedin-ads.

Marketing & SEO3.6K installs

youtube-seo

kostja94/marketing-skills

When the user wants to optimize YouTube videos for search, create video descriptions, or improve channel visibility. Also use when the user mentions "YouTube SEO," "YouTube description," "YouTube tags," "YouTube thumbnail," "YouTube title," "YouTube channel," or "video SEO." For YouTube ads, use youtube-ads.

Marketing & SEO3.4K installs

video-marketing

kostja94/marketing-skills

When the user wants to plan video marketing, create video scripts, or optimize for short-form or long-form video. Also use when the user mentions "video marketing," "video script," "short-form video," "long-form video," "TikTok script," "Reels script," "YouTube script," "video hook," or "video content strategy." For on-site video SEO, use video-optimization.

Marketing & SEO3.1K installs

tiktok-captions

kostja94/marketing-skills

When the user wants to create TikTok video captions, scripts, or optimize for TikTok. Also use when the user mentions "TikTok post," "TikTok caption," "TikTok video," "post to TikTok," "TikTok script," "TikTok content," "TikTok copy," "TikTok hashtags," or "TikTok marketing." For TikTok ads, use tiktok-ads.

Marketing & SEO2.8K installs

local-seo

kostja94/marketing-skills

When the user wants to optimize for local search, set up Google Business Profile, or build local citations. Also use when the user mentions "local SEO," "Google Business Profile," "Google Maps," "NAP," "citations," "local search," "local business," or "service area." For location pages, use programmatic-seo.

Marketing & SEO2.5K installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs