
creative-brief
This skill should be used when the user asks to "write a creative brief", "build a motion brief", "the client doesn't know what they want", "turn this vague client request into a brief", "what questions should I ask the client", or "make a brief I can get sign-off on". It turns a fuzzy client ask into a structured, sign-off-ready motion design brief and the exact clarifying questions to send back.
- Installs
- 607
- Last 24h
- +14
- Trending rank
- #7299
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/iart-ai/freelance-motion-skills --skill creative-brief- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads creative-brief automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Creative Brief
Convert a vague client ask ("we need a cool animated explainer") into a structured, sign-off-ready creative brief, and generate the exact clarifying questions to send when the client cannot articulate what they want.
When to use
Use when starting any motion project, when a client request lacks the detail needed to scope or quote, when a brief needs to be drafted for client approval, or when a "make it cool" request must be translated into concrete direction. A locked brief is the contract for creative intent; everything downstream (estimate, scope, revisions, delivery) depends on it.
Core principle
A brief is not a wish list — it is a decision document. Every project decision should trace back to one line in the brief. The job is to interrogate eleven dimensions until each has a concrete, written answer, then lock it with a sign-off line. Vague answers are not acceptable; convert each one into a specific, testable statement.
Decision tree — how far to take the brief
The judgment is how much rigour this brief needs and what to do with each gap. Don't over-process a one-day social cutdown; don't under-process a broadcast campaign.
Is the creative intent already clear and agreed in writing?
├─ YES → write a 1-page lightweight brief, confirm, proceed. Don't re-interrogate.
└─ NO → run full 11-dimension interrogation.
│
For each dimension, classify the answer:
├─ Concrete & testable → record it, move on.
├─ Vague ("cool", "modern") → run vague-translator → offer bounded choice.
├─ Blank → pull matching clarifying question (by gap).
└─ Contradictory / 3 messages → force-rank, surface the conflict to the
decision-maker, do NOT average them.
│
Can you proceed without the answer?
├─ Cosmetic gap → write best assumption, flag [ASSUMPTION — confirm].
└─ Scope/cost-defining → BLOCK. No budget, no air date, no single message,
gap (budget, no named placements = stop and resolve before
date, message, design. These set the price and the spec.
distribution)
Rule of thumb: gaps that change the price or the spec are blockers; gaps that only change execution detail become flagged assumptions.
The 11 interrogation dimensions
Capture a concrete answer for each. If the client cannot answer, send the matching clarifying question (see references/clarifying-questions.md).
- Business goal — what the business needs to change (awareness, sign-ups, sales, comprehension). Must be measurable, not "engagement."
- Audience — who watches, where their head is at, their objection. Specific persona, not "everyone."
- Core message — the ONE thing a viewer must remember. One sentence. If there are three, the brief is not done.
- Tone / feel — 3-5 adjectives plus a "but not" (e.g. "playful but not childish"). Tie to reference frames.
- Mandatories — brand assets, logo lockup rules, colour/font system, legal disclaimers, super/endcard, clearcast/regulatory needs.
- Deliverables — exact count, durations, and versions (e.g. 1× 30s hero, 3× 6s cutdowns, 1× static endframe).
- Distribution — exact placements (IG Reels, paid YouTube pre-roll, trade-show loop, broadcast). This drives spec and aspect ratios.
- References — 2-4 links with a note on what to steal from each ("the pacing here, not the colour"). Also anti-references.
- Timeline — final air date working backwards through delivery, revisions, animation, design, script/board, kickoff.
- Budget — a real number or a band. "No budget yet" is a red flag to resolve before design starts.
- Success metric — how success is judged 30 days post-launch. Defines "done well," not just "done."
Question bank by gap (which question fixes which hole)
Match the gap to the single highest-leverage question. Full send-ready bank in references/clarifying-questions.md.
| Gap in the ask | The one question that closes it |
|---|---|
| No measurable goal | "If this works, what number on a dashboard moves?" |
| Audience = "everyone" | "Who must act first? That's the audience." |
| Three messages | "Rank these 1-3; the brief carries #1, the rest become later assets." |
| Tone with no guardrail | "Pick 3-5 words — then the important one: what must it NOT feel like?" |
| Vague tone ("modern") | Run vague-translator → "Closer to A (calm/slow) or B (punchy/fast)?" |
| No mandatories listed | "Send logo files, brand guide, fonts, colours, and any legal super." |
| Fuzzy deliverables | "Exactly how many videos, what durations, which ratios/versions?" |
| "Social" (no platform) | "Which exact placements — Reels, TikTok, pre-roll, web hero, TV?" |
| No / endless references | "Send 2-4 you love (one line each on what to steal) + 1 you hate." |
| No date | "What's the hard air date, and who gives the final yes?" |
| No budget | "Projects like this run X-Y — which end are we?" |
| No success metric | "30 days out, what makes this a win?" |
Workflow
- Intake. Read the raw client ask. Extract whatever maps to the 11 dimensions; mark the rest as gaps.
- Triage gaps. For each blank or vague dimension, pull the matching clarifying question. Group them into one consolidated email — never drip-feed questions across days.
- Draft the brief. Fill the template below. Where the client was vague, write the best assumption and flag it
[ASSUMPTION — confirm]. - Pressure-test. Check the message is singular, the tone has a "but not," deliverables have counts and durations, and distribution maps to real specs.
- Send for sign-off. Include the sign-off block. No design work begins until it is returned approved.
The brief template
PROJECT BRIEF — [Project name] Date: ___ Version: ___
Client: ___ Main contact (decision-maker): ___ Prepared by: ___
1. BUSINESS GOAL
We are making this so that: [measurable change]
2. AUDIENCE
Primary: [persona, context, mindset, key objection]
3. CORE MESSAGE (the one thing)
After watching, the viewer thinks/does: [one sentence]
4. TONE / FEEL
It feels: [adj, adj, adj] — but NOT [adj, adj]
5. MANDATORIES
Logo: [lockup + rules] Colour/Type: [system]
Legal/super/endcard: [required text] Regulatory: [Y/N — body]
6. DELIVERABLES
[count × duration × ratio × format] (full list in delivery section)
7. DISTRIBUTION
Placements: [exact channels + paid/organic]
8. REFERENCES
• [link] — take: [what to steal]
• Anti-ref: [link] — avoid: [what]
9. TIMELINE (back from air date)
Air: ___ Final delivery: ___ Rev rounds: ___ Animation: ___
Design/boards: ___ Script: ___ Kickoff: ___
10. BUDGET
[number or band] — covers: [scope]
11. SUCCESS METRIC
30 days out, success = [metric + target]
ASSUMPTIONS TO CONFIRM
• [ASSUMPTION] ...
SIGN-OFF
This brief is the agreed creative intent. Changes after sign-off are
handled as change requests.
Approved by: __________ Title: ______ Date: ______
Handling "I don't know what I want"
Do not ask the client to design. Offer bounded choices instead of open questions:
- Replace "What tone do you want?" with "Closer to A (calm, premium, slow) or B (punchy, bold, fast)?"
- Replace "Any references?" with "Of these three styles, which is nearest — and what's wrong with it?"
- Force a single message: "If the viewer forgets everything but one line, which line?"
- Anchor budget with a band: "Projects like this usually land between X and Y — which end are we?"
Convert every vague adjective using the translator in references/vague-translator.md ("clean" → which of: minimal layout / lots of negative space / limited palette / slow easing?).
Worked examples
GOOD — a core-message line that closes decisions:
After watching, the viewer thinks: "Invoicing that takes 30 seconds."
One sentence, one idea, testable. Every scene can be checked against it; pacing, copy, and the endcard all trace back to this line. Full start-to-finish brief in references/worked-example.md.
ANTI-PATTERN — the "kitchen-sink" brief that guarantees revisions:
Goal: drive engagement and awareness and sign-ups. Audience: everyone who'd love our product. Message: we're innovative, affordable, easy to use, and trusted. Tone: modern, cool, fun but professional. Make it pop.
Why it fails: no measurable goal, no real audience, four competing messages, a tone with no guardrail, and an untranslated "pop." Nothing here can be approved or disproven, so round 1 becomes a discovery session on the client's dime. The fix is the entire workflow above: force one goal, one audience, one message, one "but not," and translate "pop" into a bounded choice before any design.
Common mistakes
| Symptom | Why it happens | Fix |
|---|---|---|
| Brief reads like a wish list | Captured the client's words verbatim instead of decisions | Convert every line to a concrete, testable statement |
| Round 1 turns into "what do you actually want?" | Started design with blockers unresolved | Block on goal/budget/date/message/platform before design |
| Tone keeps drifting in reviews | No "but not" guardrail set | Add the guardrail adjective; it prevents ~80% of tone revisions |
| Three messages, muddy film | Averaged competing messages instead of ranking | Force-rank; carry #1, park the rest as future assets |
| Spec/quote keeps changing | Distribution left as "social" | Pin exact placements — they define ratio, length, and price |
| Client "approves" then reopens it | No sign-off block / decision-maker unclear | Identify the single decision-maker; lock with the sign-off line |
| References pull in five directions | Endless refs, no "take" notes | Cap at 4, require a "what to steal" note + 1 anti-reference |
Deliverable spec — what a good brief contains
The output is a one-page document (the filled template) plus, when gaps exist, one consolidated clarifying email. A good brief:
- Fits roughly one page — long enough to decide, short enough to read.
- Has a concrete, testable answer in every one of the 11 dimensions (or a flagged
[ASSUMPTION]). - Carries exactly one core message and a tone with a "but not."
- Lists deliverables with counts, durations, and ratios, and distribution as named placements.
- Names the single decision-maker and ends with the sign-off block.
Before you finish — checklist
- Core message is ONE sentence (not two, not three).
- Tone has a "but not" guardrail.
- Goal is measurable; success metric has a target and a timeframe.
- Budget is a real number or an agreed band (no "TBD").
- Air date set; schedule runs backwards from it.
- Deliverables have counts + durations + ratios; distribution is named placements.
- References capped at 4, each with a "take," plus 1 anti-reference.
- Every vague adjective was translated to a concrete choice.
- Assumptions flagged
[ASSUMPTION — confirm]; decision-maker named; sign-off block present.
Related frameworks
The brief sets intent; two sibling skills turn that intent into motion direction — reference them, don't restate them here:
motion-art-direction— once tone is locked (dimension 4), pick a named Motion Personality preset there and cite it in the brief so everyone animates to the same numeric feel.animation-principles— the Three Pillars (intent → tone → craft) are the upstream version of this brief's logic; the Primary/Secondary/Ambient motion layers and the 1/3 Rule belong in execution, not the brief — don't pull them in here.
Quick reference
| Symptom | Move |
|---|---|
| "Make it pop / cool / modern" | Run the vague-translator; offer 2 bounded options |
| Three core messages | Force-rank; brief carries one, others become future assets |
| No budget given | Anchor with a band before any design |
| "Everyone" is the audience | Ask who must act first; that is the audience |
| No air date | Set delivery date first, schedule backwards |
| Endless references | Cap at 4 + require a "take" note + 1 anti-reference |
| Tone with no "but not" | Add the guardrail adjective; it prevents 80% of revisions |
Reference files
references/clarifying-questions.md— the full bank of send-ready clarifying questions, one set per dimension, plus the consolidated intake email template.references/vague-translator.md— vague-adjective → concrete-question lookup table and the bounded-choice question patterns.references/worked-example.md— a real vague ask turned into a completed brief, start to finish.
FAQ
What does the creative-brief skill do?
This skill should be used when the user asks to "write a creative brief", "build a motion brief", "the client doesn't know what they want", "turn this vague client request into a brief", "what questions should I ask the client", or "make a brief I can get sign-off on". It turns a fuzzy client ask into a structured, sign-off-ready motion design brief and the exact clarifying questions to send back.
How do I install creative-brief?
Run npx skills add https://github.com/iart-ai/freelance-motion-skills --skill creative-brief in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/creative-brief/ (personal) or .claude/skills/creative-brief/ (project).
Which AI agents can use creative-brief?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is creative-brief safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains creative-brief?
It is published by iart-ai in iart-ai/freelance-motion-skills. It has 607 recorded installs.
More from iart-ai/freelance-motion-skills
video-delivery-specs
iart-ai/freelance-motion-skills
This skill should be used when the user asks "what are the specs for Instagram Reels / TikTok / YouTube / broadcast", "export settings for social", "what aspect ratio and bitrate", "how do I repurpose 16:9 to 9:16", "safe area / title-safe for vertical", "pre-delivery checklist", or "collect files for handover". It outputs per-platform spec sheets, a cutdown matrix, captioning/accessibility notes, and a QC + collect-files checklist.
brand-motion-guidelines
iart-ai/freelance-motion-skills
This skill should be used when the user asks to "write motion guidelines", "create a brand motion system", "define easing and timing tokens", "document our animation principles", "build a motion language like Slack/IBM/Klarna", "set up entrance/exit/transition rules", or "add a reduced-motion / accessibility section". It outputs a fill-in-ready brand motion guidelines document.
client-revisions
iart-ai/freelance-motion-skills
This skill should be used when the user asks to "stop scope creep", "limit revision rounds", "write SOW revision language", "the client keeps asking for changes", "how do I say this is out of scope", "translate vague feedback", "client said make it pop", or "write a change-order email". It provides revision-cap contract language, a consolidated-feedback request, a vague-feedback translator, and a polite out-of-scope email.
motion-pricing
iart-ai/freelance-motion-skills
This skill should be used when the user asks to "quote a motion project", "estimate this animation job", "how much should I charge for this video", "what's my day rate", "build a quote", "price a 30-second explainer", or "is this estimate fair". It explains motion-design pricing models, the day-rate math, the cost drivers, and outputs a line-itemed quote with a worked example.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image