New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Content Optimization

by kostja94 in kostja94/marketing-skills

When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists.

MITAuto-check passedMarketing & SEO

Install Content Optimization

skills CLI
$ npx skills add kostja94/marketing-skills --skill content-optimization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kostja94/marketing-skills content-optimization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo/content/content-optimization .claude/skills/content-optimization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
content-optimization
GitHub stars
1k
Token cost
~2.1k tokens
SKILL.md length
935 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists.

  • Works in 3 steps: Content type: Article, guide, listicle,… → Target keyword: Primary and secondary → Competitors: Top 10 average length and…
  • Wants to optimize content for SEO—word count
  • SKILL.md covers Scope, Initial Assessment, Word Count and H2 Heading Keywords, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Content Optimization is an agent skill from kostja94/marketing-skills. 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.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering On-page SEO and Keyword research. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to optimize content for SEO—word count
  • Keyword density
  • The user mentions content length
  • Keyword stuffing

Example prompts

  • “content length,”
  • “word count,”
  • “keyword stuffing,”
  • “/content-optimization”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Content Optimization loads about 2.1k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 935 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 935 words, ~2,081 tokens.

Download SKILL.mdSave it as .claude/skills/content-optimization/SKILL.md (or your agent's skills folder).
name
content-optimization
description
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.
metadata.version
1.2.1

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

Show full SKILL.md (385 more words)Show less
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)
  • 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

© kostja94, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/seo/content/content-optimization of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

Content Optimization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Content Optimization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Content Optimization this skillkostja94/marketing-skills1k—~2.1kAutomated safety check: PassMIT
SEO Keyword ClusteringAgriciDaniel/claude-seo18k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo18k2 repos~2.6kAutomated safety check: PassMIT
SEO Content Briefseranking/seo-skills160—~2.5kAutomated safety check: PassMIT
Blog OutlineAgriciDaniel/claude-blog2.3k1 repos~1.5kAutomated safety check: PassMIT
SEO Keyword Clusterseranking/seo-skills160—~2.5kAutomated safety check: PassMIT

Similar skills

  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    18k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed

  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    18k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed

  • SEO Content Brief

    seranking/seo-skills

    Generate a writer-ready SEO content brief from a target domain and topic.

    160 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed

  • Blog Outline

    AgriciDaniel/claude-blog

    SERP-informed outline generation with H2/H3 heading hierarchy, competitive content gap analysis, section-by-section word count targets, chart and image placement markers, optional FAQ question…

    2.3k GitHub starsUsed in 1 repo~1.5k tokens
    Marketing & SEOAuto-check passed

  • SEO Keyword Cluster

    seranking/seo-skills

    Build a content cluster plan from seed keywords — intent-grouped clusters, pillar+spokes architecture with H1/H2 suggestions per spoke, prioritised build order, and an internal-linking map.

    160 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed

  • SEO Content Gap

    zubair-trabzada/dataforseo-claude

    Find keywords competitors rank for that you don't, via the DataForSEO Labs domainintersection endpoint.

    164 GitHub stars~823 tokensUpdated 4 mo ago
    Marketing & SEOAuto-check: notes

More from kostja94/marketing-skills

All 102 skills in this repo

  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed

  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated yesterday
    Auto-check passed

  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated yesterday
    Auto-check passed

  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Content Optimization

What does Content Optimization do?

When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists. Content Optimization is an agent skill from kostja94/marketing-skills. When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists.

When should I use Content Optimization?

Content Optimization fits situations like: wants to optimize content for SEO—word count; keyword density; the user mentions content length; keyword stuffing.

How do I install Content Optimization in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill content-optimization -a claude-code`. Or copy the skill folder (skills/seo/content/content-optimization in kostja94/marketing-skills) into .claude/skills/content-optimization in your project. Claude Code loads it when a task matches its description.

How do I install Content Optimization in Codex?

Run `npx skills add kostja94/marketing-skills --skill content-optimization -a codex`. Or copy the skill folder (skills/seo/content/content-optimization in kostja94/marketing-skills) into .agents/skills/content-optimization in your project. Codex loads it when a task matches its description.

Can I use Content Optimization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kostja94/marketing-skills --skill content-optimization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/content-optimization, .gemini/skills/content-optimization, .github/skills/content-optimization and .opencode/skills/content-optimization in your project.

What does Content Optimization need to run?

SKILL.md names no scripts, command-line tools or credentials: Content Optimization is instructions for the agent only.

Does Content Optimization access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Content Optimization safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Content Optimization use?

Content Optimization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Content Optimization use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Content Optimization?

Skills that share tags, products or a category with Content Optimization: SEO Keyword Clustering (AgriciDaniel/claude-seo, 18k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 18k stars), SEO Content Brief (seranking/seo-skills, 160 stars) and Blog Outline (AgriciDaniel/claude-blog, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Content Optimization?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,016 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

Source: kostja94/marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.