SEO Content Brief Claude Skill
The SEO Content Brief Claude skill produces research-backed writing briefs for content teams and marketers who need pages that can outrank the current top results. It is free and open source under the MIT license, written by puneetindersingh and shipped inside Agrici Daniel's claude-seo repository on GitHub.
/plugin marketplace add AgriciDaniel/claude-seo/plugin install claude-seo@agricidaniel-claude-seonpx skills add AgriciDaniel/claude-seo --skill seo-content-briefWhat the SEO Content Brief skill does
A good brief tells a writer what to cover, how long each section should be and why this page can win. This skill has Claude read the top ranking pages for a keyword, drop non-competitors such as forums and directories, score the real ones, and find topic, depth and quality gaps.
It works in two modes. For a new page, it builds the brief from the keyword and your site's context. For an existing URL, it keeps what is strong and lists only what to add or fix, rather than recommending a rewrite by default.
Two rules keep briefs honest. Every suggestion must be something your site can credibly deliver, and every brief must name the specific new value the page adds, such as original data or first-hand experience, instead of vague promises of more detail.
- Builds new-page briefs or improve-existing-page briefs from a keyword or URL
- Analyzes the top five ranking pages and filters out non-competitors
- Scores competitors on depth, formatting, SEO and user experience
- Classifies search intent and the page format the search results reward
- Produces an outline with per-section word counts and keyword placement notes
- Recommends title tags and meta descriptions within set length limits
- Specifies the information gain and E-E-A-T signals the page needs
- Suggests internal links with anchor text based on your sitemap
How it works
Pick the mode
Claude checks whether you gave an existing URL, which means an improve brief, or only a keyword, which means a new page brief.
Fetch site context
It reads your homepage and sitemap to learn what you offer, so suggestions match your real services and link to real pages.
Analyze the results
Claude studies the top results, removes non-competitors, scores the rest, and lists topic, depth and quality gaps.
Classify intent
It labels the intent as informational, commercial, transactional or navigational and notes the format Google currently rewards.
Write the brief
You get competitor table, gaps, a winning outline with word counts, meta tags, unique angle, trust signals and internal link ideas.
Example prompts
Once the SEO Content Brief skill is installed, ask Claude in plain language. These prompts trigger it:
- Write a content brief for the keyword email deliverability checklist
- Create a brief to improve our existing pricing guide at example.com/pricing-guide
- Give me just a content outline for a service page on commercial roofing
- Build a blog brief for best CRM for small agencies
- What would make our page better than the top five results for this keyword
What you get
- A competitor analysis table with scores and main gaps
- A winning outline with H1, slug, word targets and section notes
- Recommended title tag and meta description
- A unique angle statement and list of trust signals to include
- Internal linking suggestions with anchor text
Who it is for
- Content marketers briefing freelance or in-house writers
- SEO teams who want gap analysis before commissioning a page
- Founders updating underperforming pages with targeted improvements
- Agencies that need a repeatable brief format for clients
How to install the SEO Content Brief skill
What you need: Claude Code or an agent that can fetch web pages. Optional DataForSEO or Ahrefs MCP tools add real SERP and volume data. No scripts are required.
- Claude Code plugin
/plugin marketplace add AgriciDaniel/claude-seo - Claude Code plugin
/plugin install claude-seo@agricidaniel-claude-seo - Skills CLI
npx skills add AgriciDaniel/claude-seo --skill seo-content-brief - Manual
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && cp -r claude-seo/skills/seo-content-brief ~/.claude/skills/seo-content-brief
After installing, restart Claude Code or start a new session. Claude loads the SEO Content Brief skill automatically when your request matches it, or you can ask for it by name.
Tips for better results
- Share your URL even for a new page. The site relevance rule depends on knowing your real services.
- Name the page type, such as blog post or service page, so Claude uses the right template.
- Add DataForSEO or Ahrefs if you have them. Otherwise word counts and difficulty are estimates.
Limitations
- Without SERP or SEO tool data, competitor analysis relies on whatever Claude can fetch from the results.
- It writes a brief, not the article itself, so you still need a writer or a drafting step.
SEO Content Brief Claude skill FAQ
Yes. It is MIT licensed and part of Agrici Daniel's open-source claude-seo repository on GitHub. Optional integrations such as DataForSEO are paid services, but the skill itself costs nothing.
In Claude Code, run /plugin marketplace add AgriciDaniel/claude-seo, then /plugin install claude-seo@agricidaniel-claude-seo, then use /seo content-brief with a keyword or URL. The Skills CLI line below installs just this skill.
Skills that are just a SKILL.md plus reference files can be zipped and uploaded in Claude.ai under Settings, Capabilities, Skills on paid plans. This one has no bundled scripts, so it can work there, but it needs web access to read competing pages, which Claude Code provides. Claude Code is the safest choice.
This skill's briefs include search intent, a competitor table, content gaps, an outline with word counts per section, keyword placement, meta tags, a unique angle, trust signals and internal links. It also supports an outline-only mode.
Yes. Give the skill a URL and it uses improve mode. It separates what to keep and strengthen from what to add, and avoids recommending a full rewrite when targeted changes would do the job.