/content-brief — SEO content brief

Target: $ARGUMENTS

Targets and thresholds: ${CLAUDE_PLUGIN_ROOT}/skills/seo-fundamentals/references/scoring-spec.md. Ground-truth rules: ${CLAUDE_PLUGIN_ROOT}/skills/seo-fundamentals/SKILL.md.

Research

1. Entity and keywords — primary entity (Knowledge Graph entity, not just the string), primary keyword and intent, 5–8 secondary keywords, 3–5 question keywords (PAA), 3–5 semantically related terms.
2. Query fan-out — 8–12 sub-queries AI Mode would decompose the query into (definition, how-to, comparison, troubleshooting, best practice, alternatives, cost, when).
3. Competitive landscape — top-10 content types, lengths (median), structures, snippet opportunities, presence of an AI Overview.
4. Entity coverage — run /entity-coverage (or reuse its output). The brief must list the MUST-COVER entities and 5–8 information-gain points by name; each gain point becomes an outline section. If /entity-coverage cannot run, build a lighter matrix from the top 5 and say so.

Brief output

Header — target keyword, primary entity, intent, target length (SERP median +20–30%), audience, content type, difficulty.

Keywords table — primary (title, H1, first 50 words as sentence subject, 2–3 H2s, conclusion, slug), secondary (body, some H2/H3), questions (H2/H3 for snippets), related terms (naturally). No density target — the spam floor is 3%.

Outline — H1 with the primary entity; each H2/H3 tagged [MUST-COVER], [OPPORTUNITY], [INFORMATION GAIN], or [FAN-OUT TARGET: sub-query]; snippet targets marked. For each section: purpose (2–3 sentences), key points, how competitors handle it, differentiation angle, and the requirement that the first 40–60 words after the heading answer the heading's question.

Material the writer must obtain — for each information-gain point: the real data, case, quote, or screenshot needed and from whom. State explicitly that placeholders [NEEDS REAL DATA] are acceptable in drafts and fabricated material is not.

Meta draft — 3 title options (50–60 chars, entity front-loaded, click copy) and 3 descriptions (150–160 chars, value + CTA); slug (3–5 words). Final variants via /meta-tags.

Snippet strategy — target format (paragraph 40–60 words / list 5–9 items / table / definition), target question, placement right after the matching H2.

Links — 3–5 internal targets (existing pages), 2–3 external primary sources.

Schema — Article + Person (author, sameAs) + BreadcrumbList; FAQ only if the Q/A will be in the body verbatim.

Engagement requirements — hook type, where real anecdotes go (2–3), CTA placement (first within 500 words), visual notes.

Quality targets — length, Flesch ≥50 (60–70 for broad audiences), heading every 300–400 words, ≥4 citable passages per 1,000 words, ≥8 specialized entities, ≥3 information-gain points, ≥3 internal links, 2–3 external primary sources, publish threshold 70/100 with AI Overviews readiness ≥ PARTIAL.

Next: /write-seo with this brief.