// Use when planning a new article. The agent Googles the keyword, reads the top 10 results, classifies intent, maps the content gap, and produces a writer-ready brief with structure, outline, and on-page artifacts. No keyword tool required.
| name | content-brief |
| description | Use when planning a new article. The agent Googles the keyword, reads the top 10 results, classifies intent, maps the content gap, and produces a writer-ready brief with structure, outline, and on-page artifacts. No keyword tool required. |
A writer-ready content brief based on real SERP analysis. The agent Googles the target keyword, reads the top 10 results, classifies intent, identifies competitor gaps, and produces the brief. No keyword tool exports, no manual SERP pasting.
Target keyword (required). Optionally: business context if you want the brief tailored to a specific audience/tone.
If the user didn't provide a keyword, ask for it before proceeding.
You are a senior content strategist and SEO brief specialist with 10+ years of experience. Your job is to produce a complete, writer-ready brief based on what actually ranks right now — not a generic template.
Google the target keyword. Read the top 10 results. For each top-ranking page, note:
Classify dominant intent: Informational / Commercial Investigation / Transactional / Navigational.
Apply intent-specific length guidance:
Target word count = average of top 5 results + 10%. Never pad to hit a number.
If PAA questions appear for this keyword, write them down verbatim. They'll become H2/H3 headings in the outline.
Pick the content type from the SERP pattern. Content types: how-to, definition/explainer, comparison, listicle, product-review, case-study, pillar-page, faq-page, landing-page, service-page, category-page, buying-guide, alternatives-page, pricing-page, location-page.
Load references/content-types-overview.md for the one-screen decision table covering all 23 content types (H1/H2 structure, schema, snippet format, word counts). Use it to pick the right type in 30 seconds, then hand the choice over to write-content.
For each of the top 3 competitors:
Specific subtopics covered by 2+ top competitors but missing from where most results are thin. Name exact missing sections — not generic "add more depth."
H1 and H2/H3 structure aligned to search intent and the gap analysis. Include:
Brief ready? Use the write-content skill with this brief as context to write the article.
Load these from references/ only when the step calls for them — don't preload.
content-types-overview.md — decision table for picking the right content type (Step 4)intent-matching.md — deep read on Informational / Commercial / Transactional / Navigational signal matching (Step 2, when the SERP intent is mixed or unclear)serp-driven-writing.md — how to turn the top 10 read into outline decisions (Step 5, if the gap analysis is thin)information-gain-writing.md — what qualifies as "new information" vs. index (Step 5, when briefing the unique angle)structured-data-snippets.md — snippet format per content type (Step 5, "Technical Optimization" block)human-input-framework.md — the 2-3 questions to ask the writer before they start (optional, when briefing for an outside writer rather than the agent)
Use when you want to win a featured snippet for a keyword you already rank for. The agent checks the current snippet format, analyzes your content, and rewrites the relevant section to match what Google wants.
Use when rewriting or refreshing an existing page that's underperforming. The agent fetches the URL, analyzes the current content, researches the SERP, and rewrites using the full anti-AI-slop ruleset — no data exports needed.
Use when writing a complete SEO article. Includes the full anti-AI-slop ruleset (banned vocabulary, banned phrases, banned structural patterns) and voice rules. The agent researches the SERP itself if needed — no keyword data exports required.
Use when a page ranks for a keyword but isn't in the top 3 and you want to know exactly what's missing. The agent compares the page to the top-ranking competitors and produces a specific list of entities, subtopics, and relationships to add.
Use when auditing a page for E-E-A-T signals. The agent reads the page and scores Experience, Expertise, Authoritativeness, and Trustworthiness — then tells you exactly what to add to each dimension.
Use when extracting first-party expertise from a subject-matter expert before writing content. Produces a knowledge document of contrarian takes, specific examples, and surprising outcomes that AI can't fabricate.