| name | content-brief |
| description | Create a production-ready content brief a writer can execute without extra context — keyword map (primary, secondary, related questions), H2/H3 outline with key points and word-count targets, brand voice guidance, on-page SEO checklist, visual/media spec with AI-generation and C2PA provenance notes, and success metrics. Triggers on "/digital-marketing-pro:content-brief", "write a brief for this topic", "brief a blog post on X", "what should this article cover", "outline and SEO requirements for a pillar page". Preferred upstream of /digital-marketing-pro:content-engine. Reads the brand profile, guidelines, and compliance rules. |
| argument-hint | [topic] |
/digital-marketing-pro:content-brief
Purpose
Create a production-ready content brief that a writer can execute without additional context. Includes keyword strategy, content outline, structural requirements, brand voice guidelines, and on-page SEO specifications.
Input Required
The user must provide (or will be prompted for):
- Topic or working title: What the content is about
- Content type: Blog post, landing page, pillar page, guide, whitepaper, etc.
- Target keyword(s): Primary keyword or topic cluster (or ask for research)
- Target audience: Who this content is for
- Funnel stage: Awareness, consideration, or decision
- Competitive URLs: Optional — existing content to outperform
Process
- Load brand context: Read
~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply brand voice, compliance rules for target markets (skills/context-engine/compliance-rules.md), and industry context. Also check for guidelines at ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json — if present, load restrictions and relevant category files. Check for custom templates at ~/.claude-marketing/brands/{slug}/templates/. Check for agency SOPs at ~/.claude-marketing/sops/. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults.
- Research keyword landscape: primary keyword, secondary keywords, related questions
- Analyze top-ranking content for the target keyword to identify gaps and opportunities
- Define content angle and unique value proposition versus existing results
- Build a detailed outline with H2/H3 structure, key points per section, and word count targets
- Specify on-page SEO requirements: title tag, meta description, URL slug, internal links, schema markup
- Document voice and tone guidelines specific to this piece
- Define success metrics: target ranking, traffic, engagement, conversions
Output
A structured content brief containing:
- Target keyword map (primary, secondary, related/co-occurring terms, questions to answer) — note keyword placement (title, intro, ≥2 H2s, conclusion, meta), not a density target
- Content outline with heading hierarchy and key points per section
- Word count target and content format specifications
- Brand voice and tone guidance for this specific piece
- On-page SEO checklist (title, meta, headers, links, schema)
- Visual/media requirements — specify whether visuals are AI-generated and which model (see guidance below)
- Internal and external linking strategy
- Success metrics and measurement plan
Visual/media spec — AI generation guidance (May 2026)
If the piece includes AI-generated images, infographics, or short video, the brief must specify:
- Model:
Nano Banana Pro for high-fidelity stills with on-image text (best text rendering in any image model as of May 2026), Gemini Omni for connected hero-image + cutdown-video + audio packages, or alternatives (Midjourney, Firefly, gpt-image-1) for concept work.
- Provenance marking: All AI assets shipped to EU readers must carry C2PA Content Credentials. Default to "sign all AI visuals" — the cost of running
/digital-marketing-pro:c2pa-metadata post-production is trivial vs the Article 50 penalty exposure.
- Deepfake / synthetic-human flag: If the visual includes a photoreal human (real or synthetic), call this out — synthetic humans typically need a visible disclosure under the final EU Article 50 Guidelines (applicable 2 Aug 2026).
- Editorial-responsibility owner: For long-form on health, finance, elections, or public-safety topics, name the human editor who will sign off. AI-written copy on these topics requires the editorial-responsibility carve-out to skip an "AI-assisted" byline disclosure — see
skills/context-engine/compliance-rules.md §1.1b.i.
Agents Used
- content-creator — Outline structure, angle, voice guidelines, content strategy
- seo-specialist — Keyword research, on-page SEO requirements, competitive content analysis
