creative-brief · rampstackco — Claude Code skill: align on project before building
creative-brief turns a vague idea into a concrete brief that a designer or developer can pick up and run with. Use it to lock down scope, audience, and success metrics before the first line of code.
MIT 354 installs ★ 1,107 updated 2026-10-19
npx skills add rampstackco/claude-skills --skill creative-brief -a claude-codeWhat creative-brief does
The skill runs as a structured intake: asks ten targeted questions (what is the project, who is it for, why does it exist, what is in scope, what are the constraints), collects answers, and outputs a two-page brief in markdown. Each section—from audience and objectives to voice, visual direction, and success criteria—gives designers and developers exactly what they need to move forward without guessing.
The skill includes prompts to fill gaps. If you come with half an answer (say, just "website for a coffee shop"), it does not generate a stub. Instead it asks about your core customer, a measurable outcome, how you want to sound. Saves the brief as creative-brief.md in the project root, ready to convert to Word or PDF for stakeholders.
The skill knows its lanes. It triggers on "creative brief", "project kickoff", "briefing the team", "where do we start", but stays out of design systems, PRDs, or initial discovery if other skills own those.
What it helps with
- get the team aligned before work starts
- translate a hazy idea into actionable direction for a contractor or AI agent
- nail down target audience, their pain points, and what winning looks like
- lock scope and explicitly say what is not being built
- sync brand voice and visual direction in one document
Example prompts for the agent
- Create a brief for our new coffee shop website
- Help us structure the project so everyone knows what we are building before we kick off
- I have an idea but I do not know what to tell the designer or where to start
How to install creative-brief
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill creative-brief -a claude-code2Manually: put the files in place
~/.claude/skills/creative-brief/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/creative-brief/
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill creative-brief -a codex2Manually: put the files in place
.agents/skills/creative-brief/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill creative-brief -a cursor2Manually: put the files in place
.cursor/skills/creative-brief/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rampstackco/claude-skills skills/creative-brief2Manually: put the files in place
.github/skills/creative-brief/SKILL.md1Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill creative-brief -a gemini-cli2Platform CLI
gemini skills install https://github.com/rampstackco/claude-skills --path skills/creative-briefManually: put the files in place
.devin/skills/creative-brief/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rampstackco/claude-skills --skill creative-brief -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 creative-brief
How do I install creative-brief in Claude Code?
Run npx skills add rampstackco/claude-skills --skill creative-brief -a claude-code, then open ~/.claude/skills/creative-brief/SKILL.md.
What does the creative-brief skill do?
It gathers answers to ten core questions about your project (audience, goals, scope, constraints, success), then produces a structured brief in markdown that you can hand to your team or developer.
When should I use creative-brief instead of design-standards or pm-spec-writing?
Use creative-brief to kick off a project and sync your team early. If you already know the direction and need design principles, use design-standards. If scope is locked and you need a PRD or dev ticket, use pm-spec-writing.
Source text
SKILL.md · MIT
--- name: creative-brief description: "Create or refine a creative brief that bridges discovery and execution. Use this skill whenever the user is starting a new project, kicking off a website, beginning a brand build or redesign, briefing a designer or developer or AI agent, or trying to align a team before building. Triggers on creative brief, design brief, brand brief, project kickoff, kicking off, briefing the team, project intake, design direction, brief the designer, brief the dev, where do we start, how do we start, write a brief, project overview, scope this project, align on direction. Also triggers when the user has a vague idea and needs to make it concrete enough to hand off, even if they do not say 'brief' explicitly." category: strategy-and-discovery catalog_summary: "Project briefs that align stakeholders before work starts" display_order: 2 --- # Creative Brief Bridges discovery and execution. Translates "we want a website" into a brief a designer, developer, or AI agent can actually run with. --- ## When to use - Starting a new project (website, app, brand, campaign) - Kicking off a redesign or rebrand - Handing work to a designer, developer, or AI agent - Aligning a team that has drifted off course - Turning a vague idea into something buildable ## When NOT to use - The user is asking a one-off design question (use `design-standards`) - The user wants a PRD or dev ticket (use `pm-spec-writing`) - The user is doing initial research and has not decided what they are building (use `brand-discovery` first) - The user just wants you to write copy (use `content-and-copy`) - The user already has scope and constraints settled and needs deeper aesthetic direction specifically (use `creative-direction` for the structured aesthetic axes) --- ## Required inputs A brief needs answers to ten questions. Before writing, confirm you have answers (or can elicit them) for: 1. What is the project? 2. Why does it exist? What problem does it solve? 3. Who is the audience? 4. What do you want them to do, feel, or know? 5. What is the personality? How does it sound? 6. What is the visual direction? How does it look? 7. What is in scope? What is out? 8. What are the constraints (time, budget, technical, brand)? 9. What does success look like? 10. Who approves? If you have fewer than five of these, run a quick intake first. See "Eliciting missing info" below. --- ## The framework: brief structure Output a markdown brief with these ten sections. Keep each section tight. A good brief is two pages, not ten. ### 1. Snapshot One paragraph answering: what, who, why, when. The kind of thing you would say at a kickoff in thirty seconds. ### 2. Audience Primary audience first. Include who they are, what they are trying to do, what is blocking them today, and where you reach them. Add secondary audiences only if they materially change the work. ### 3. Objectives What success looks like. Pair every objective with a measurable signal. > Objective: drive trial signups. > Signal: 3 percent conversion from homepage to signup within 30 days of launch. ### 4. Key message The one thing you want a visitor to walk away knowing. If they see only the homepage hero and bounce, what should they remember? One sentence. ### 5. Voice and tone Pick three to five adjectives. Pair each with what you are NOT (e.g. "confident, not arrogant"). See [`references/voice-and-tone-guide.md`](references/voice-and-tone-guide.md) for frameworks and worked examples. ### 6. Visual direction Mood, palette, type, and imagery direction. Three to five reference URLs are worth more than 500 words. Note what you like AND what you would reject. ### 7. Scope and deliverables A bulleted list of what is being made. Be specific. "Homepage" is not a deliverable. "Homepage with hero, three feature blocks, testimonial carousel, and contact CTA" is. ### 8. Constraints Time. Budget. Technical (existing stack, required integrations, hosting). Brand (logo, colors, fonts that must be used). Legal (compliance, accessibility level required). ### 9. Inspiration and competitors Three to five sites or brands you want to feel like, three to five you want to feel different from. Note WHY for each. ### 10. Approval Who signs off. What artifact triggers sign-off (a Figma file, a staging URL, a PDF). What happens if there is no sign-off by a deadline. --- ## Eliciting missing info If the user comes with a partial answer (e.g., "I want a website for my coffee shop"), do not just write a generic brief. Ask. Use these prompts. **For audience** - Who is the single most likely person to land on this site? Walk me through their day. - If you could pick one type of customer to fill your inbox, who? - Who do you NOT want to attract? **For objectives** - Pretend it is six months after launch. What number tells you it worked? - What is the one action you most want a visitor to take? **For voice** - Pick three brands or people whose tone you would want to borrow. - If your site were a person at a dinner party, what would they sound like? **For visuals** - Show me three sites you love. What do you love about them? - Show me one site you hate. Why? **For scope** - If you only got one page, which one? - What would you cut if the budget were halved? Do not ask all of these. Pick the ones that fill the actual gaps. --- ## Workflow 1. **Read the conversation.** Pull every fact already given. Do not ask questions you can answer from context. 2. **Identify gaps.** Which of the ten required inputs are missing or thin? 3. **Run intake.** Ask three to five targeted questions to fill the gaps. Group related questions to keep the conversation tight. 4. **Draft the brief.** Use [`references/creative-brief-template.md`](references/creative-brief-template.md) as the structure. Keep it under 1500 words. 5. **Stress-test.** Before delivering, check the brief against the failure patterns below. If any apply, revise before showing the user. 6. **Deliver.** Save as `creative-brief.md` in the project root. Offer to make it a Word doc or PDF if the user wants something to share with stakeholders. 7. **Hand off for aesthetic depth (optional).** For projects where sections 5 (voice and tone) and 6 (visual direction) need more rigor than this brief surfaces, run `creative-direction` next. It produces a structured aesthetic brief using four directional axes (tone register, aesthetic philosophy, audience relationship, sensory ambition) that content, copy, and art-direction skills consume directly. --- ## Failure patterns When the user's input matches one of these patterns, push back before writing. - **"We want to be the [giant brand] of [our niche]."** Ask what specifically about that brand they want to borrow. Probably one or two things, not the whole thing. - **Audience as "men and women 18-65."** This is not an audience. Ask for the single most valuable customer type and start there. - **"Increase awareness" with no metric.** Awareness of what, by whom, measured how? Push for a number. - **"Modern, clean, minimalist."** These words are meaningless. Ask for three specific URLs they think look right. - **Twenty pages of context, no clear ask.** Ask: "If a designer reads only one paragraph, what should it be?" Then make that the snapshot. --- ## Output format Default output is a markdown file at `creative-brief.md` in the project root. Structure follows the template exactly. If the project is large, split: keep the main brief under 1500 words and put detail in linked appendices (`audience-research.md`, `brand-guidelines.md`, etc.). Briefs that try to be everything end up read by no one. --- ## Reference files - [`references/creative-brief-template.md`](references/creative-brief-template.md) - Fillable template. Copy and use as the starting point. - [`references/voice-and-tone-guide.md`](references/voice-and-tone-guide.md) - Voice frameworks, brand archetypes, and worked patterns. - [`references/example-brief.md`](references/example-brief.md) - A worked example for a fictional B2B SaaS, showing what a "good" filled brief looks like. Read the template before drafting. Read the voice guide if the user has not already specified a voice. Read the example if you are unsure how filled-out a section should be.
© rampstackco · MIT · rampstackco/claude-skills
Similar skills
All skills for Design →creative-brief by other authors comes first.