What is seo-content-optimization?

A guide to improving existing web content by comparing it with search results, covering missing topics, updating outdated information, and finding competing pages on the same subject.

Use it to refresh old pages, audit content, improve featured-snippet opportunities, merge short pages, and address multiple pages competing for one search term.

It helps diagnose declining or weak search performance without starting every piece of content from scratch.

seo-content-optimization — Skill for Claude Code by brainbytes-dev

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add brainbytes-dev/everything-claude-marketing --skill seo-content-optimization

Clone the repo

git clone --depth 1 https://github.com/brainbytes-dev/everything-claude-marketing

Made for: Claude Code.

Or install everything-claude-marketing, the plugin that ships this one along with the rest of its 72 skills, 22 commands, 18 agents, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/brainbytes-dev/everything-claude-marketing/seo-content-optimization/github.svg)](https://agentmods.dev/skills/brainbytes-dev/everything-claude-marketing/seo-content-optimization)

Your own site

<a href="https://agentmods.dev/skills/brainbytes-dev/everything-claude-marketing/seo-content-optimization"><img src="https://agentmods.dev/badge/skills/brainbytes-dev/everything-claude-marketing/seo-content-optimization/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/brainbytes-dev/everything-claude-marketing/seo-content-optimization"><img src="https://agentmods.dev/badge/skills/brainbytes-dev/everything-claude-marketing/seo-content-optimization.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 3,176 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00031	$0.03176
Opus 5.5	$0.00012	$0.01270
Sonnet 5.5	$0.00006	$0.00635
Haiku 4.5	$0.00003	$0.00318

Measured 2mo ago against content hash de2431b289cc, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

seo-content-optimization scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/seo/seo-content-optimization/SKILL.md · 299 lines

How it starts

The opening of the file, as written. The whole thing — 299 lines — stays where its author put it; the contents beside it link to each section on GitHub.

When to Activate

Use this skill when updating existing content to improve search rankings, diagnosing why a page isn't ranking as expected, refreshing decaying content, merging thin pages, optimizing for featured snippets and SERP features, or performing a content audit to identify optimization opportunities.

First Questions

Which pages need optimization? (declining traffic, stuck on page 2, underperforming expectations)
What are the target keywords and current rankings?
What does the SERP look like for these keywords? (who ranks, what format, what SERP features)
When was the content last updated?
What's the page's current backlink profile? (are ranking issues content-related or authority-related?)
Is there keyword cannibalization? (multiple pages competing for the same keyword)

Content Refresh Strategy

Content decay is inevitable. Pages that once ranked well lose traffic over time as information becomes outdated, competitors publish better content, and Google refreshes its understanding of quality.

When to Refresh Content

Traffic declining: Page has lost 20%+ organic traffic over 3-6 months
Rankings slipping: Dropped from page 1 to page 2, or from top 3 to positions 5-10
Outdated information: Statistics, dates, tools, or processes have changed
Competitive gap: Competitors have published more comprehensive content
SERP changes: Google now shows different content formats (video, listicle vs. guide)
Age: Content over 12-18 months old should be evaluated for refresh

Content Refresh Process

Audit current performance: Pull Search Console data for the past 12 months — track impressions, clicks, CTR, and average position over time
Analyze the SERP: Google the target keyword. What do top-ranking pages include that yours doesn't?
Identify gaps: Compare your content against the top 5 ranking pages — what topics, subtopics, entities, or media do they cover that you miss?
Update the content:
- Refresh statistics and dates
- Add missing subtopics and entities
- Improve the introduction (the first 100 words matter most)
- Update the title tag and meta description for better CTR
- Add or update images, charts, and multimedia
- Improve internal linking
- Add structured data if missing
Update the published date: Change to the current date (this signals freshness to Google)
Resubmit for indexing: Request indexing in Search Console
Monitor: Track rankings and traffic for 4-8 weeks after the update

Read the full file on GitHub · 299 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 299 lines · 31 tokens per session scan A de2431b289cc

Subscribe to this mod's changes

seo-content-optimization is a skill published in the GitHub repository brainbytes-dev/everything-claude-marketing (10 stars, last pushed 7mo ago), licensed MIT. It adds 31 tokens to every session and 3,176 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Marketing and SEO