Agent skill

Content Optimizer

by MadAppGang in MadAppGang/claude-code

On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability.

MITAuto-check passedMarketing & SEO

Install Content Optimizer

skills CLI
$ npx skills add MadAppGang/claude-code --skill content-optimizer -a claude-code

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

GitHub CLI
$ gh skill install MadAppGang/claude-code content-optimizer --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/MadAppGang/claude-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/seo/skills/content-optimizer .claude/skills/content-optimizer && 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-optimizer
GitHub stars
284
Used in
1 other repo
Token cost
~694 tokens
SKILL.md length
276 words
Files
1
Skills in repo
69
Repo updated
First seen
Licence
MIT

At a glance

On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability.

  • Works in 5 steps: Title/H1 (required) → First 100 words (required) → At least one H2 (recommended) → …
  • Optimizing existing content
  • SKILL.md covers When to Use, Keyword Density, Meta Tag Optimization and Heading Structure, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Content Optimizer is an agent skill from MadAppGang/claude-code. On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability. Use when optimizing existing content or validating new content against SEO requirements.

Its SKILL.md is about 690 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 Plain language and style rules. The repository describes itself as: claude code plugins marketplace. The licence is MIT.

When your agent uses it

  • Optimizing existing content
  • Validating new content against SEO requirements

Example prompts

  • “/content-optimizer”

Workflow steps

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

  1. Title/H1 (required)
  2. First 100 words (required)
  3. At least one H2 (recommended)
  4. Conclusion (recommended)
  5. Distributed in body (natural)

What it can do on your machine

Read from SKILL.md and the folder at commit 6097ad4. 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 Optimizer loads about 694 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 276 words of instructions outside code blocks.

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

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 MadAppGang/claude-code at commit 6097ad4, republished under its MIT licence (© MadAppGang). 276 words, ~694 tokens.

Download SKILL.mdSave it as .claude/skills/content-optimizer/SKILL.md (or your agent's skills folder).
name
content-optimizer
description
On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability. Use when optimizing existing content or validating new content against SEO requirements.
plugin
seo
updated
2026-01-20

plugin: seo updated: 2026-01-20

Content Optimizer

When to Use

  • Optimizing existing content for better rankings
  • Validating new content against SEO requirements
  • Checking keyword density and placement
  • Improving readability scores
  • Creating meta tags

Keyword Density

Target: 1-2% for primary keyword

Calculation:

Density = (Keyword Count / Total Words) x 100

Placement Priorities:

  1. Title/H1 (required)
  2. First 100 words (required)
  3. At least one H2 (recommended)
  4. Conclusion (recommended)
  5. Distributed in body (natural)

Warning Signs:

  • 3% = Keyword stuffing risk

  • <0.5% = Under-optimized
  • Exact match every paragraph = Unnatural

Meta Tag Optimization

Title Tag
  • Length: 50-60 characters
  • Keyword: Near the beginning
  • Format: {Keyword} - {Benefit} | {Brand}
  • Unique per page
Meta Description
  • Length: 150-160 characters
  • Keyword: Include naturally
  • CTA: End with action verb
  • Unique per page
URL Slug
  • Short: 3-5 words
  • Keyword: Include primary
  • Readable: Use hyphens
  • Lowercase only

Heading Structure

Valid Hierarchy:

H1: Page Title (exactly 1)
+-- H2: Main Section
|   +-- H3: Subsection
|   +-- H3: Subsection
+-- H2: Main Section
|   +-- H3: Subsection
+-- H2: Conclusion

Common Errors:

  • Multiple H1 tags
  • Skipping levels (H1 -> H3)
  • Using headings for styling only
  • No keyword in H1

Readability Optimization

Flesch Reading Ease Target: 60-70

ScoreLevelAudience
90-100Very Easy5th grade
80-89Easy6th grade
70-79Fairly Easy7th grade
60-69Standard8th-9th grade
50-59Fairly Difficult10th-12th grade
30-49DifficultCollege
0-29Very DifficultCollege graduate

Improvement Techniques:

  • Shorten sentences (<20 words avg)
  • Shorten paragraphs (2-3 sentences)
  • Replace jargon with plain language
  • Use active voice
  • Add subheadings every 200-300 words
  • Use bullet points for lists

Optimization Checklist

Use this checklist when optimizing content:

  • Primary keyword in title/H1
  • Primary keyword in first 100 words
  • Keyword density 1-2%
  • Meta title 50-60 characters
  • Meta description 150-160 characters with CTA
  • Heading hierarchy valid (H1 -> H2 -> H3)
  • At least 3 internal links
  • At least 1 external authoritative link
  • Flesch score 60-70
  • No paragraphs > 3 sentences
  • Subheadings every 200-300 words

© MadAppGang, 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 plugins/seo/skills/content-optimizer of MadAppGang/claude-code.

Open the folder on GitHubat commit 6097ad4

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in MadAppGang/claude-code, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Content Optimizer 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 Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Content Optimizer this skillMadAppGang/claude-code2841 repos~694Automated safety check: PassMIT
Metadata Checkjdevalk/skills104—~1kAutomated safety check: PassMIT
SEO ContentAgriciDaniel/codex-seo7915 repos~2.3kAutomated safety check: PassMIT
SEO Optimizersecondsky/claude-skills227—~1.6kAutomated safety check: PassMIT
Content SEOjdevalk/skills104—~2.3kAutomated safety check: PassMIT
SEO OptimizerOneWave-AI/claude-skills3231 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Metadata Check

    jdevalk/skills

    Reviews short high-value strings — page titles, meta descriptions, schema description fields, FAQ answers, GitHub repo taglines, profile bios, social-card copy, and other metadata where Flesch and…

    104 GitHub stars~1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • SEO Content

    AgriciDaniel/codex-seo

    Content quality and E-E-A-T analysis with AI citation readiness assessment.

    791 GitHub starsUsed in 5 repos~2.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Optimizer

    secondsky/claude-skills

    SEO optimization with keyword analysis, readability assessment, technical validation, content quality.

    227 GitHub stars~1.6k tokensUpdated 10 days ago
    Marketing & SEOAuto-check passed
  • Content SEO

    jdevalk/skills

    Audits a blog post draft or page copy for content-level SEO: search intent fit, focus keyphrase placement, E-E-A-T signals (experience, expertise, authoritativeness, trustworthiness), helpfulness…

    104 GitHub stars~2.3k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • SEO Optimizer

    OneWave-AI/claude-skills

    Optimize content for search engines with keyword analysis, readability scoring, meta descriptions, and competitor comparison.

    323 GitHub starsUsed in 1 repo~1.7k tokens
    Writing & ContentAuto-check passed
  • 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

More from MadAppGang/claude-code

All 69 skills in this repo
  • API Spec Analyzer

    MadAppGang/claude-code

    Analyzes API documentation from OpenAPI specs to provide TypeScript interfaces, request/response formats, and implementation guidance.

    284 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Content Brief

    MadAppGang/claude-code

    Content brief template and creation methodology for SEO-optimized content.

    284 GitHub starsUsed in 1 repo~959 tokens
    Auto-check passed
  • Context Detection

    MadAppGang/claude-code

    A skill your agent uses when detecting project technology stack from files/configs/directory structure, auto-loading framework-specific skills, or analyzing multi-stack fullstack projects (e.g…

    284 GitHub stars~5.4k tokensUpdated 6 mo ago
    Auto-check passed
  • Keyword Cluster Builder

    MadAppGang/claude-code

    Techniques for expanding seed keywords and clustering by topic and intent.

    284 GitHub starsUsed in 1 repo~674 tokens
    Auto-check passed
  • Serp Analysis

    MadAppGang/claude-code

    SERP analysis techniques for intent classification, feature identification, and competitive intelligence.

    284 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Technical Audit

    MadAppGang/claude-code

    Technical SEO audit methodology including crawlability, indexability, and Core Web Vitals analysis.

    284 GitHub starsUsed in 1 repo~909 tokens
    Auto-check passed

Categories

Questions about Content Optimizer

What does Content Optimizer do?

On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability. Content Optimizer is an agent skill from MadAppGang/claude-code. On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability.

When should I use Content Optimizer?

Content Optimizer fits situations like: optimizing existing content; validating new content against SEO requirements.

How do I install Content Optimizer in Claude Code?

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

How do I install Content Optimizer in Codex?

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

Can I use Content Optimizer 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 MadAppGang/claude-code --skill content-optimizer -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-optimizer, .gemini/skills/content-optimizer, .github/skills/content-optimizer and .opencode/skills/content-optimizer in your project.

What does Content Optimizer need to run?

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

Does Content Optimizer 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 Optimizer 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 Optimizer use?

Content Optimizer 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 Optimizer use?

About 694 tokens (SKILL.md is roughly 2.8k 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 Optimizer?

Skills that share tags, products or a category with Content Optimizer: Metadata Check (jdevalk/skills, 104 stars), SEO Content (AgriciDaniel/codex-seo, 791 stars), SEO Optimizer (secondsky/claude-skills, 227 stars) and Content SEO (jdevalk/skills, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Content Optimizer?

MadAppGang (a GitHub organization) maintains it in MadAppGang/claude-code, which has 284 GitHub stars. The repository holds 69 skills in this directory. The repository was last updated on March 15, 2026.

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