content-brief-generator — Claude Code skill: what it does
The content-brief-generator skill builds structured briefs for articles, docs, landing pages, and other formats. Use it when a writer needs a clear audience, goal, outline, and SEO direction.
MIT 207 installs ★ 236 updated 2026-01-14
npx skills add jamesrochabrun/skills --skill content-brief-generator -a claude-codeWhat content-brief-generator does
content-brief-generator turns a content request into a working brief. It can capture the working title, format, audience, goal, main takeaway, funnel stage, tone, length, outline, research needs, and media requirements. The listed use cases include blog posts, technical documentation, marketing copy, social posts, case studies, reports, product descriptions, and video scripts.
The skill also covers search intent, primary and supporting keywords, meta descriptions, heading plans, and linking requirements. For the content shape, it offers AIDA, PAS, the inverted pyramid, and a storytelling arc. The workflow starts with generate_brief.sh, then moves through research, outlining, drafting, review, SEO work, approval, publication, and tracking. It prepares the assignment; it does not publish the finished piece for you.
What it helps with
- build a brief for a blog post or landing page
- define the reader, goal, and main takeaway
- map keywords to search intent
- set requirements for technical documentation
- choose a framework for marketing copy
Example prompts for the agent
- Create a brief for an article about API migration with the audience, goal, main takeaway, outline, and SEO requirements.
- Prepare a technical documentation brief that calls for code examples, prerequisites, and accuracy checks.
- Draft a landing-page brief using AIDA and include a clear call-to-action requirement.
How to install content-brief-generator
1Skills CLI (Vercel)
npx skills add jamesrochabrun/skills --skill content-brief-generator -a claude-code2Manually: put the files in place
~/.claude/skills/content-brief-generator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/content-brief-generator/
1Skills CLI (Vercel)
npx skills add jamesrochabrun/skills --skill content-brief-generator -a codex2Manually: put the files in place
.agents/skills/content-brief-generator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jamesrochabrun/skills --skill content-brief-generator -a cursor2Manually: put the files in place
.cursor/skills/content-brief-generator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jamesrochabrun/skills skills/content-brief-generator2Manually: put the files in place
.github/skills/content-brief-generator/SKILL.md1Skills CLI (Vercel)
npx skills add jamesrochabrun/skills --skill content-brief-generator -a gemini-cli2Platform CLI
gemini skills install https://github.com/jamesrochabrun/skills --path skills/content-brief-generatorManually: put the files in place
.devin/skills/content-brief-generator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jamesrochabrun/skills --skill content-brief-generator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about content-brief-generator
How do I install content-brief-generator in Claude Code?
Run npx skills add jamesrochabrun/skills --skill content-brief-generator -a claude-code, then use ~/.claude/skills/content-brief-generator/SKILL.md.
What does content-brief-generator do?
It creates structured briefs for content work, covering the audience, goals, format, outline, research, SEO, voice, and media needs.
Which content formats does the skill cover?
It covers articles, technical documentation, marketing copy, social media posts, case studies, reports, product descriptions, and video scripts.
Source text
SKILL.md · MIT
--- name: content-brief-generator description: Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats. --- # Content Brief Generator A comprehensive skill for creating detailed content briefs that guide writers, ensure consistency, and align content with business goals. ## What This Skill Does Helps you create professional content briefs for: - **Blog posts and articles** - Thought leadership, tutorials, how-tos - **Technical documentation** - API docs, guides, README files - **Marketing copy** - Landing pages, email campaigns, ads - **Social media content** - Posts, campaigns, threads - **Case studies** - Customer success stories - **Whitepapers and reports** - In-depth research content - **Product descriptions** - E-commerce and product pages - **Video scripts** - YouTube, explainer videos, demos ## Why Content Briefs Matter **Without a brief:** - Unclear expectations and scope - Multiple rounds of revisions - Inconsistent tone and messaging - Missing SEO opportunities - Wasted time and resources **With a brief:** - Clear direction and goals - Fewer revisions needed - Consistent quality - SEO-optimized content - Efficient workflow ## Core Components of a Content Brief ### 1. Content Overview - Title/working title - Content type (blog, doc, landing page, etc.) - Target audience - Primary goal (educate, convert, entertain, etc.) - Key message or takeaway ### 2. Audience & Context - Target persona - Reader's knowledge level - Pain points and needs - Where they are in the funnel - How they'll discover content ### 3. Strategic Elements - Business objectives - SEO keywords and intent - Competitive landscape - Success metrics - CTAs and conversion goals ### 4. Content Requirements - Tone and voice - Length/word count - Structure and sections - Research requirements - Visual/media needs ### 5. SEO & Distribution - Primary and secondary keywords - Search intent - Meta description - Internal/external links - Distribution channels ## Content Types & Templates ### Blog Post Brief **Use for:** Thought leadership, tutorials, listicles, how-tos **Key elements:** - Hook and introduction angle - Main points (typically 3-7) - Examples and data to include - Call-to-action - Internal linking strategy ### Technical Documentation Brief **Use for:** API docs, guides, developer documentation **Key elements:** - Technical accuracy requirements - Code examples needed - Audience technical level - Prerequisites - Related documentation ### Landing Page Brief **Use for:** Product pages, signup pages, campaign pages **Key elements:** - Value proposition - Benefits vs. features - Social proof requirements - Conversion goal - A/B testing plan ### Case Study Brief **Use for:** Customer success stories, testimonials **Key elements:** - Customer background - Problem/solution/results framework - Metrics and outcomes - Quotes needed - Industry context ## Content Structure Frameworks ### AIDA (Attention, Interest, Desire, Action) **Best for:** Marketing copy, sales pages 1. **Attention:** Grab with headline 2. **Interest:** Build with benefits 3. **Desire:** Create want with proof 4. **Action:** Drive with clear CTA ### PAS (Problem, Agitate, Solve) **Best for:** Blog posts, email campaigns 1. **Problem:** Identify pain point 2. **Agitate:** Emphasize urgency 3. **Solve:** Present solution ### Inverted Pyramid **Best for:** News, technical docs 1. Most important info first 2. Supporting details 3. Background context ### Storytelling Arc **Best for:** Case studies, narratives 1. Setup (character/situation) 2. Conflict (challenge) 3. Resolution (solution) 4. Takeaway (lesson) ## SEO Integration ### Keyword Strategy - Primary keyword (1) - Secondary keywords (2-3) - Long-tail variations (3-5) - LSI keywords (related terms) ### Search Intent - **Informational:** Learn about something - **Navigational:** Find specific page - **Commercial:** Compare options - **Transactional:** Ready to buy ### On-Page SEO - Title tag (include primary keyword) - Meta description (compelling + keyword) - Headers (H1, H2, H3 with keywords) - Image alt text - Internal linking ## Tone & Voice Guidelines ### Tone Spectrum - **Formal ↔ Casual** - **Serious ↔ Playful** - **Respectful ↔ Irreverent** - **Enthusiastic ↔ Matter-of-fact** ### Voice Attributes Define your brand voice: - **Professional but approachable** (like Stripe) - **Technical but friendly** (like Twilio) - **Playful and bold** (like Mailchimp) - **Authoritative and trustworthy** (like HubSpot) ### Writing Style - Active vs. passive voice - Person (1st, 2nd, 3rd) - Sentence length - Paragraph structure - Use of jargon ## Research & Sourcing ### Research Requirements - **Primary research:** Interviews, surveys, original data - **Secondary research:** Industry reports, competitor analysis - **Expert quotes:** SME interviews, third-party experts - **Data and statistics:** Credible sources, recent data - **Examples:** Real-world cases, screenshots ### Citation Standards - Link to original sources - Attribute quotes - Recent data (within 1-2 years) - Authoritative sources - Fact-checking requirements ## Visual & Media Requirements ### Images - Hero image specifications - In-content images (how many, what type) - Screenshots or diagrams - Charts or infographics - Alt text requirements ### Video/Audio - Video length and format - Screen recordings needed - B-roll requirements - Audio quality standards ### Other Media - Code snippets - Downloadable resources - Interactive elements - Embedded content ## Workflow & Process ### 1. Brief Creation (This Skill) Use `generate_brief.sh` to create comprehensive brief ### 2. Research & Outline Writer researches and creates outline ### 3. First Draft Writer creates content following brief ### 4. Review & Edit Editor reviews against brief requirements ### 5. SEO Optimization SEO review and optimization ### 6. Final Approval Stakeholder sign-off ### 7. Publication Publish and distribute ### 8. Performance Tracking Monitor metrics defined in brief ## Success Metrics by Content Type ### Blog Post - Organic traffic - Time on page (3+ minutes) - Scroll depth - Social shares - Backlinks - Lead generation ### Technical Documentation - Page views - Time on page - Search rankings - Feedback ratings - Support ticket reduction ### Landing Page - Conversion rate - Bounce rate - Time on page - Click-through rate - Form submissions ### Case Study - Downloads - Leads generated - Sales pipeline influence - Share rate ## Common Content Brief Mistakes ### ❌ Avoid These **Too Vague:** "Write about our product" → No clear audience, goal, or angle **No Research:** Missing competitor analysis and keyword research → Content won't rank or differentiate **Unclear Voice:** "Make it engaging" → Not specific enough for consistency **Missing CTAs:** No clear next step for readers → Missed conversion opportunities **Ignoring SEO:** No keyword strategy → Content won't be discovered ### ✅ Do This Instead **Specific:** "Write 1500-word tutorial for junior developers on JWT authentication, including code examples in Node.js" **Research-Backed:** "Target keyword 'JWT authentication tutorial' (2.4K monthly searches), compete with existing articles from Auth0 and FreeCodeCamp" **Clear Voice:** "Technical but approachable - explain like a senior dev mentoring a junior, use examples, avoid jargon" **Action-Oriented:** "CTA: Sign up for free API key, secondary: Join Discord community" **SEO-Optimized:** "Primary: 'JWT authentication', Secondary: 'JSON web token Node.js', 'secure API authentication'" ## Using This Skill ### Generate a Content Brief ```bash ./scripts/generate_brief.sh ``` Interactive workflow will guide you through: 1. Content type and audience 2. Goals and objectives 3. SEO requirements 4. Structure and requirements 5. Success metrics ### Validate a Brief ```bash ./scripts/validate_brief.sh path/to/brief.md ``` Checks for: - Required sections present - Keyword strategy defined - Target audience specified - Success metrics included - Completeness score ### Access Templates ``` references/content_brief_template.md - Complete template references/seo_guidelines.md - SEO best practices references/content_frameworks.md - Structure frameworks references/tone_voice_guide.md - Voice guidelines ``` ## Content Brief Checklist - [ ] **Clear title** and content type - [ ] **Target audience** defined with persona details - [ ] **Primary goal** and business objective - [ ] **Keyword research** completed - [ ] **Search intent** identified - [ ] **Tone and voice** specified - [ ] **Word count** target - [ ] **Structure** and key sections outlined - [ ] **Research sources** identified - [ ] **Examples** and data requirements - [ ] **Visual needs** specified - [ ] **CTAs** defined - [ ] **Success metrics** established - [ ] **Competitor content** analyzed - [ ] **Distribution plan** outlined ## Quick Start Examples ### "Create a blog post brief" System generates comprehensive brief with: - SEO keyword strategy - Audience targeting - Structure recommendations - Success metrics ### "Write technical documentation brief for API" System creates technical brief with: - Technical requirements - Code example specifications - Audience skill level - Documentation standards ### "Generate landing page brief" System builds conversion-focused brief with: - Value proposition guidance - CTA strategy - A/B testing recommendations - Conversion metrics ## Best Practices ### 1. Start With Research - Analyze top-ranking content - Understand search intent - Identify content gaps - Review competitor approach ### 2. Be Specific - Exact word count - Specific examples needed - Clear tone guidelines - Defined success metrics ### 3. Align With Strategy - Connect to business goals - Fit content calendar - Support funnel stage - Match brand voice ### 4. Make It Actionable - Clear deliverables - Specific requirements - Concrete examples - Measurable outcomes ### 5. Iterate and Improve - Track performance - Update based on results - Refine over time - Learn from top performers ## Integration With Other Workflows ### Content Calendar Brief creation triggers calendar entry ### SEO Tools Keywords from SEMrush, Ahrefs, etc. ### Project Management Brief becomes Jira/Asana task ### CMS Brief exported to content management system ### Analytics Success metrics tracked in dashboards ## Tips for Different Writer Types ### Content Writers - Focus on audience and storytelling - Emphasize research requirements - Clear brand voice guidelines ### Technical Writers - Specify technical accuracy needs - Define audience knowledge level - Include code example requirements ### Copywriters - Highlight conversion goals - Specify A/B testing needs - Clear CTA strategy ### Content Marketers - Connect to funnel stage - Define distribution strategy - Specify lead generation goals ## Resources All reference materials included: - Complete content brief template - SEO optimization guidelines - Content structure frameworks - Tone and voice development guide - Copywriting formulas and examples ## Summary Content briefs ensure: - **Clarity** - Everyone knows expectations - **Efficiency** - Fewer revisions needed - **Quality** - Consistent, strategic content - **Results** - Content that achieves goals Use this skill to create comprehensive briefs that guide writers to success. --- **Remember:** Time spent on a good brief saves 10x time in revisions. Get it right before writing begins.
© jamesrochabrun · MIT · jamesrochabrun/skills