inhouseseo/content-brief
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.
npx skills add https://github.com/inhouseseo/superseo-skills --skill content-brief
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)Take inhouseseo/content-brief from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.