New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Content Brief Generator

by jamesrochabrun in jamesrochabrun/skills

Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.

MITAuto-check passedWriting & Content

Install Content Brief Generator

skills CLI
$ npx skills add jamesrochabrun/skills --skill content-brief-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jamesrochabrun/skills content-brief-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jamesrochabrun/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/content-brief-generator .claude/skills/content-brief-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
content-brief-generator
GitHub stars
216
Used in
1 other repo
Token cost
~2.9k tokens
SKILL.md length
1,310 words
Files
6 (incl. scripts, references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.

  • Works in 12 steps: Content Overview → Audience & Context → Strategic Elements → …
  • Tasks that involve Content strategy
  • SKILL.md covers What This Skill Does, Why Content Briefs Matter, Core Components of a Content… and Content Types & Templates, plus 4 more sections
  • Runs Shell scripts from its folder

What it does

Content Brief Generator is an agent skill from jamesrochabrun/skills. Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/content_frameworks.md`, `references/seo_guidelines.md` and `references/tone_voice_guide.md`).

It sits in Writing & Content, covering Content strategy. The licence is MIT.

When your agent uses it

  • Tasks that involve Content strategy

Example prompts

  • “/content-brief-generator”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Content Overview
  2. Audience & Context
  3. Strategic Elements
  4. Content Requirements
  5. SEO & Distribution
  6. Brief Creation (This Skill)
  7. Research & Outline
  8. First Draft
  9. Review & Edit
  10. SEO Optimization
  11. Final Approval
  12. Publication

What it can do on your machine

Read from SKILL.md and the folder at commit 2482c17. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Content Brief Generator loads about 2.9k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 1,310 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jamesrochabrun/skills at commit 2482c17, republished under its MIT licence (© jamesrochabrun). 1,310 words, ~2,904 tokens.

Download SKILL.mdSave it as .claude/skills/content-brief-generator/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
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

Show full SKILL.md (497 more words)Show less
✅ 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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/content-brief-generator of jamesrochabrun/skills.

  • SKILL.md
  • references/content_frameworks.md
  • references/seo_guidelines.md
  • references/tone_voice_guide.md
  • scripts/generate_brief.sh
  • scripts/validate_brief.sh

Open the folder on GitHubat commit 2482c17

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in jamesrochabrun/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Content Brief Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Content Brief Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Content Brief Generator this skilljamesrochabrun/skills2161 repos~2.9kAutomated safety check: PassMIT
Blogger Distillerotter1101/blogger-distiller693—~3.8kAutomated safety check: NotesMIT
Linkedin Content Plannersergebulaev/linkedin-skills4.3k1 repos~2.1kAutomated safety check: PassMIT
Blog Post Draftingluongnv89/claude-howto42k—~2.1kAutomated safety check: PassMIT
Benchmark Account ImporterXBuilderLAB/cheat-on-content7.2k1 repos~2.3kAutomated safety check: NotesMIT
WeChat Hot Article AnalysisSpaceZephyr/creator-buddy1.6k—~847Automated safety check: PassNone

Similar skills

  • Blogger Distiller

    otter1101/blogger-distiller

    A skill your agent uses when the user wants to analyze or distill a blogger/account on Xiaohongshu or Douyin, benchmark a target creator, or diagnose their own content strategy.

    693 GitHub stars~3.8k tokensUpdated 15 days ago
    Writing & ContentAuto-check: notes

  • Linkedin Content Planner

    sergebulaev/linkedin-skills

    Generate a 7-day LinkedIn content plan from a theme, audience, and pillars.

    4.3k GitHub starsUsed in 1 repo~2.1k tokens
    Writing & ContentAuto-check passed

  • Blog Post Drafting

    luongnv89/claude-howto

    Guides drafting a blog post from an idea and optional source material: research, brainstorming, outlining and version-tracked drafts, with user approval at each step.

    42k GitHub stars~2.1k tokensUpdated 8 days ago
    Writing & ContentAuto-check passed

  • Benchmark Account Importer

    XBuilderLAB/cheat-on-content

    Imports scripts and engagement numbers from an account you want to emulate, then extracts content patterns and starting scoring signals from them.

    7.2k GitHub starsUsed in 1 repo~2.3k tokens
    Writing & ContentAuto-check: notes

  • WeChat Hot Article Analysis

    SpaceZephyr/creator-buddy

    Fetches hot WeChat Official Account articles by sector or keywords and produces a data file and an HTML report with rankings, style patterns and writing references.

    1.6k GitHub stars~847 tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed

  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    32k GitHub starsUsed in 3 repos~1.9k tokens
    Writing & ContentAuto-check passed

More from jamesrochabrun/skills

All 23 skills in this repo

  • Prd Generator

    jamesrochabrun/skills

    Generate comprehensive Product Requirements Documents (PRDs) for product managers.

    216 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed

  • LLM Router

    jamesrochabrun/skills

    This skill should be used when users want to route LLM requests to different AI providers (OpenAI, Grok/xAI, Groq, DeepSeek, OpenRouter) using SwiftOpenAI-CLI.

    216 GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed

  • Technical Launch Planner

    jamesrochabrun/skills

    Plan and execute technical product launches for developer tools, APIs, and technical products.

    216 GitHub starsUsed in 1 repo~3.8k tokens
    Auto-check passed

  • Design Brief Generator

    jamesrochabrun/skills

    Generate comprehensive design briefs for design projects. An agent skill from jamesrochabrun/skills.

    216 GitHub stars~3.3k tokensUpdated 8 mo ago
    Auto-check passed

  • Git Worktrees

    jamesrochabrun/skills

    Manage Git worktrees for parallel Claude Code development. An agent skill from jamesrochabrun/skills.

    216 GitHub stars~4.2k tokensUpdated 8 mo ago
    Auto-check passed

  • Swiftui Animation

    jamesrochabrun/skills

    This skill provides comprehensive guidance for implementing advanced SwiftUI animations, transitions, matched geometry effects, and Metal shader integration.

    216 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Categories

Questions about Content Brief Generator

What does Content Brief Generator do?

Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats. Content Brief Generator is an agent skill from jamesrochabrun/skills. Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.

When should I use Content Brief Generator?

Content Brief Generator fits situations like: tasks that involve Content strategy.

How do I install Content Brief Generator in Claude Code?

Run `npx skills add jamesrochabrun/skills --skill content-brief-generator -a claude-code`. Or copy the skill folder (skills/content-brief-generator in jamesrochabrun/skills) into .claude/skills/content-brief-generator in your project. Claude Code loads it when a task matches its description.

How do I install Content Brief Generator in Codex?

Run `npx skills add jamesrochabrun/skills --skill content-brief-generator -a codex`. Or copy the skill folder (skills/content-brief-generator in jamesrochabrun/skills) into .agents/skills/content-brief-generator in your project. Codex loads it when a task matches its description.

Can I use Content Brief Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jamesrochabrun/skills --skill content-brief-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/content-brief-generator, .gemini/skills/content-brief-generator, .github/skills/content-brief-generator and .opencode/skills/content-brief-generator in your project.

What does Content Brief Generator need to run?

Going by SKILL.md and its folder, Content Brief Generator needs a shell for the scripts in its folder. Our summary lists: Node.js; A Bash shell.

Does Content Brief Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Content Brief Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Content Brief Generator use?

Content Brief Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Content Brief Generator use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Content Brief Generator?

Skills that share tags, products or a category with Content Brief Generator: Blogger Distiller (otter1101/blogger-distiller, 693 stars), Linkedin Content Planner (sergebulaev/linkedin-skills, 4.3k stars), Blog Post Drafting (luongnv89/claude-howto, 42k stars) and Benchmark Account Importer (XBuilderLAB/cheat-on-content, 7.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Content Brief Generator?

jamesrochabrun (a GitHub user) maintains it in jamesrochabrun/skills, which has 216 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on January 14, 2026.

Source: jamesrochabrun/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.