SEO Content Brief Skill
Your agent writes the brief from the live results and your own Search Console data, then scores the draft before you publish.
- Built from today's top results
- Checks you do not already rank
- Free draft scoring before publishing
Skill
seomatic-content-brief v1.0.0
Needs
SEOmatic's MCP server (free account)
Works In
Claude Code, Claude, Cursor, Codex, Gemini CLI, OpenClaw, Hermes Agent, Grok Bot and any agent that reads Agent Skills
Source
SKILL.md on GitHub, MIT license
Last Checked
October 2026
Inside the Content Brief Skill
The Short Answer
The SEOmatic content brief skill teaches an AI agent to write a brief for one target keyword from real data: volume, difficulty and intent, the questions people search around it, the search features on the results page, and what the top three ranking pages all cover and what none of them cover. It checks Search Console first so you do not write a second page for a query you already rank for, and it scores the finished draft for free before publishing. SEOmatic can stage the article or write it, and nothing goes live until you click approve.
What You Get
A brief with the target keyword, intent, format, working title and meta description, what to cover, the angle no competitor takes, the questions to answer directly, internal links to add and the facts to verify.
Ask Your Agent
Once the skill is installed, ask in your own words. For example:
- "Write a content brief for 'invoice software for freelancers'."
- "What should my article on this keyword include?"
- "Score this draft before I publish it."
How the Skill Works
- The keyword
- The results today
- The brief
- Score the draft
Every number comes from a tool result with its exact date range. The skill never estimates a figure it could read.
Tools It Uses
| Tool | What it reads or does | Cost |
|---|---|---|
keyword_research | Keyword Research | Free questions or AI credits |
serp_competitors | SERP & Competitors | Free questions or AI credits |
gsc_performance | Search Console Performance | Free |
site_pages | Site & Page Analysis | Free |
task_manage | SEO Tasks | Free to stage; paid plan, your approval |
generate_article | Generate Article | One prepaid article unit |
All from SEOmatic's MCP server. Parameters and full cost rules: MCP tool reference.
Install the Skill
One command installs it in Claude Code, Cursor, Codex, Gemini CLI, OpenCode and other agents that read Agent Skills. Then connect SEOmatic's MCP server at https://app.seomatic.ai/api/mcp and sign in (free, no card). In Claude on the web or desktop, upload the skill folder as a zip under Settings, Capabilities, Skills. Setup for every agent: AI assistants.
npx skills add Minh42/seomatic-mcp --full-depth --skill seomatic-content-briefNothing Goes Live Without You
By default, nothing changes on your site until you approve it. A fix is staged as a proposal that says what will change and why. Approved fixes run within seconds, the page's previous state is stored, and any edit to an existing page can be rolled back. A rollback refuses to overwrite edits someone made since. Changes that could take a page out of Google, like a noindex, need an extra confirmation.
Run It on a Schedule
This skill is part of the Content Planner Grok Bot template, which run it on a schedule and only speak when something changed. All templates: SEO skills and templates.
More SEO Skills
Frequently Asked Questions
Does the brief set a word count?
No. Coverage decides length. The brief gives the range the top results run so you know what to expect.
Can SEOmatic write the article too?
Yes. On a paid plan the brief can be staged as a content task. On any plan, a single research-grounded article costs one prepaid article unit, and the agent names that cost before writing.
Is the Content Brief skill free?
The skill is free and open source (MIT). Connecting is free with no card. Search Console reports, page checks and 30-page site audits are free, as often as you like. Live market data (keyword volumes, competitors, backlinks) uses free questions: 5 a month, plus a one-time 10 when you connect Search Console, and one question covers up to 5 lookups. Staging and publishing fixes is part of paid plans, which start with a 14-day trial.
Which AI agents can use it?
Any agent that reads Agent Skills (SKILL.md): Claude Code, Claude on the web and desktop, Cursor, Codex, Gemini CLI, OpenCode, Kiro, OpenClaw, Hermes Agent, Grok Bot and more. It installs with one command: npx skills add.
Do I need SEOmatic's MCP server?
Yes. The skill tells your agent how to do the job; SEOmatic's MCP server gives it your real data and the tools. Connecting is free: add https://app.seomatic.ai/api/mcp to your agent and sign in.