/dm:content-brief
Generates a structured content brief with keyword strategy, outline, SEO specs, and brand voice guidelines for writers.
What this file does
Generates a structured content brief with keyword strategy, outline, SEO specs, and brand voice guidelines for writers.
When to use it
- You need a writer-ready brief for a blog post or landing page
- You want SEO-optimized content aligned with brand voice
- You're outsourcing content and need to reduce back-and-forth
- You're creating pillar pages or whitepapers with competitive analysis
name: content-brief description: "Create detailed content briefs. Use when: keyword targets, outline, structure, voice guidelines, SEO requirements." argument-hint: "[topic]"
/dm: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.jsonfor 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 (/dm: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, LSI, questions to answer)
- 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
- Internal and external linking strategy
- Success metrics and measurement plan
Agents Used
- content-creator — Outline structure, angle, voice guidelines, content strategy
- seo-specialist — Keyword research, on-page SEO requirements, competitive content analysis
What's inside
8 output sections: keyword map, outline, word count, voice guidance, SEO checklist, media requirements, linking strategy, success metrics.
Change this for your project
- Replace
~/.claude-marketing/brands/_active-brand.jsonwith your brand config path - Replace
~/.claude-marketing/sops/with your agency SOPs directory - Replace
skills/context-engine/compliance-rules.mdwith your compliance rules file
Where it goes
Save as SKILL.md inside a skill folder. Loaded when the agent selects that skill.
Worth borrowing
- Loading brand context from a JSON file before generating content ensures consistency
- Checking for custom templates and guidelines per brand via a manifest file
Related Documents
AI Artist — Engineering Specification
Defines a 21-section engineering specification for a prompt construction skill, covering contracts, deterministic design, error taxonomy, and production readiness.
Image Generation Skill
Provides Python functions for generating, editing, and transforming images via DALL-E 3, FLUX (Replicate/fal.ai), and local Stable Diffusion, plus utilities and prompt engineering helpers.
draw.io Diagram Skill
Defines a complete workflow for creating, editing, exporting, and linting draw.io diagrams as native.drawio XML, including AWS icon support and SVG overlap checking.
Manage After Effects
Defines 8 action types and a JSON config format to automate After Effects composition building, rendering, and diagnostics from the command line or Python.