seo-content-brief

seo-content-brief is a skill for Claude Code from lionkiii/claude-seo-skills. It costs 79 tokens per session (2,239 once invoked), scanned C, original, MIT.

A writing plan for a target search phrase, based on current Ahrefs search-result data. Ahrefs is an SEO research service that shows how pages and keywords perform in search.

In plain words
What is it for?
Planning article topics, structure, and improvements, with optional Google Search Console data showing your site’s existing rankings and clicks.
Why use it?
It replaces guesswork about what an article should cover with information about pages already ranking for the phrase.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; mentions subagents; mentions Claude Code.

Part of the claude-seo-skills plugin — 51 skills, 6 agents shipped together

Good fit Planning article topics, structure, and improvements, with optional Google Search Console data showing your site’s existing rankings and clicks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/lionkiii/claude-seo-skills/seo-content-brief
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 lionkiii/claude-seo-skills --skill seo-content-brief
Clone the repo
git clone --depth 1 https://github.com/lionkiii/claude-seo-skills

Made for: Claude Code.

Or install claude-seo-skills, the plugin that ships this one along with the rest of its 51 skills, 6 agents.

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.

agentmods badge for seo-content-brief

README.md
[![agentmods](https://agentmods.dev/badge/skills/lionkiii/claude-seo-skills/seo-content-brief/github.svg)](https://agentmods.dev/skills/lionkiii/claude-seo-skills/seo-content-brief)
Your own site
<a href="https://agentmods.dev/skills/lionkiii/claude-seo-skills/seo-content-brief"><img src="https://agentmods.dev/badge/skills/lionkiii/claude-seo-skills/seo-content-brief/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.

agentmods 80×15 button for seo-content-brief

Your own site · 80×15
<a href="https://agentmods.dev/skills/lionkiii/claude-seo-skills/seo-content-brief"><img src="https://agentmods.dev/badge/skills/lionkiii/claude-seo-skills/seo-content-brief.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 79 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,239 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00079 $0.02239
Opus 5 $0.00039 $0.01120
Sonnet 5 $0.00016 $0.00448
Haiku 4.5 $0.00008 $0.00224

Measured 12d ago against content hash d1500afacfe0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade C, and why

seo-content-brief scanned grade C with 2 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 12d 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- Verify with: cat ~/.claude/mcp.json | grep -i ahrefs

Reads MCP configurationmediumAgent snooping

mcp.json carries server URLs and auth tokens; reading it lets a mod discover and abuse other integrations.

- Verify with: cat ~/.claude/mcp.json | grep -i ahrefs
skills/seo-content-brief/SKILL.md · 241 lines

How it starts

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

SEO Content Brief Generator

Produces a structured, copy-pasteable content brief for writers by analyzing live SERP data from Ahrefs. When a site parameter is provided and GSC MCP is available, overlays current ranking position and click data for targeted improvement guidance.

Note: SERP analysis is inlined here — skills cannot call each other as sub-routines in Claude Code.

References

@skills/seo/references/mcp-degradation.md @skills/seo/references/ahrefs-api-reference.md @skills/seo/references/gsc-api-reference.md

Inputs

  • keyword: The target keyword for the content brief (required). Example: "best crm for startups"
  • site (optional): GSC property URL to overlay existing ranking data. Accepts both formats:
    • Domain property: sc-domain:example.com
    • URL prefix: https://example.com/ or https://www.example.com/

MCP Check

Primary check (required):

  1. Use ToolSearch with query +ahrefs
  2. If tools returned → Ahrefs MCP is available, proceed to Execution
  3. If no tools returned → display the Ahrefs MCP error template from references/mcp-degradation.md and stop

Optional GSC check (only if site parameter was provided):

  1. Use ToolSearch with query +google-search-console
  2. If tools returned → GSC MCP is available, will overlay ranking data in Step 3
  3. If no tools returned → note "GSC data unavailable — brief generated from SERP data only" and proceed

Execution

Step 1 — SERP Analysis (INLINE)

Note: SERP analysis is inlined here because Claude Code skills cannot call each other as sub-routines. The following replicates the seo-serp logic directly.

1a. Use ToolSearch with query serp-overview to inspect the tool definition and discover its parameter names. The keyword parameter may be named keyword, query, or term — do not assume. Use the exact parameter name found in the schema for the call.

1b. Call mcp__claude_ai_ahrefs__serp-overview using the discovered parameter name with the user's keyword as the value.

Read the full file on GitHub · 241 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.

  1. 12d ago First seen · 241 lines · 79 tokens per session scan C d1500afacfe0

Subscribe to this mod's changes

seo-content-brief is a skill published in the GitHub repository lionkiii/claude-seo-skills (20 stars, last pushed 3mo ago), licensed MIT. It adds 79 tokens to every session and 2,239 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it C with 2 findings (reads agent configuration directories, reads mcp configuration). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

seo-images

Image SEO audit for a URL or domain. Pulls raw image inventory via Firecrawl, then audits alt-text quality, modern-format coverage (WebP / AVIF), responsive sizing (srcset / sizes), lazy-loading and LCP signals (loading, fetchpriority, decoding), CLS-safe dimensions, descriptive file names, and ImageObject JSON-LD.…

amirjahfar1/automate-seo-with-claude · 225 tokens

seo-technical-audit

Focused one-shot technical SEO audit for a domain. Crawlability, indexability, security, mobile, structured data, JS rendering — single-pass deliverable, not a diff. Distinct from seo-drift (which tracks changes over time) and from seo-page (which audits keywords/traffic for one URL, not technical health). Use when…

amirjahfar1/automate-seo-with-claude · 109 tokens

seo-api

DataForSEO API integration architect for developers. Covers the entire DataForSEO surface — DataForSEO Labs (ranked keywords, keyword ideas/suggestions/related, domain rank overview, competitors, domain/page intersection, subdomains, relevant pages, bulk keyword difficulty, bulk traffic estimation, search intent…

amirjahfar1/automate-seo-with-claude · 411 tokens

seo-ads

Paid-search competitive landscape for a domain or keyword. Reconstructs the paid footprint keyword-by-keyword from live SERP ad blocks — advertisers, ad copy patterns, who else bids on the same keywords, CPC/competition signals, SERP shopping/ad-pack visibility — and produces a competitive ads brief plus a recommended…

amirjahfar1/automate-seo-with-claude · 113 tokens

seo-backlinks-profile

Full backlink profile for a domain — referring domains, anchor text distribution, authority distribution, IP and subnet diversity, growth/decay trend, toxic-candidate flagging. Distinct from seo-backlink-gap (which is gap-vs-competitor only). Produces a profile health score and reviewable disavow candidate list (never…

amirjahfar1/automate-seo-with-claude · 116 tokens

seo-content-audit

E-E-A-T + CITE quality audit for an EXISTING piece of content. Scores Experience, Expertise, Authoritativeness, Trustworthiness, and citation-readiness for AI search; surfaces veto items that block publication; produces a publish / publish-with-fixes / no-publish verdict. Distinct from seo-content-brief (produces a…

amirjahfar1/automate-seo-with-claude · 138 tokens