1---2name: creative-brief3description: >-4 Turns a theme, a post or an ad angle into a creative brief a designer can build without a meeting: the one5 message, the format and why, the visual concept and panel count, the on-image copy line by line, the text around6 it, and the proof each claim rests on. Writes 2 executions that really differ, then checks its own copy with7 voice-check and claim-check before handing over. Use it after choosing an ad angle or a post to turn into a8 visual. Not for choosing the angle (use ad-themes), writing ad variants at scale (use ad-variants) or reviewing9 finished ads (use ad-creative-critic).10license: MIT11compatibility: >-12 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Reads the platform's current ad specs13 if the agent can browse; otherwise marks sizes and limits to confirm. Never generates the image itself.14metadata:15 author: SHAKEUP16 version: "1.0.0"17 stage: make18 plugin: creative-conversion19 homepage: https://www.shakeuphq.com/skills/creative-brief20---21 22# Creative brief23 24Specs one piece of creative so the designer builds the right thing the first time, with every claim on it backed.25 26## Purpose27 28- One job: one brief for one piece (a social image, a multi-panel post, a video, a static or video ad, a page hero), with 2 executions.29- Stage: make. It ends with its own check.30- It never makes the asset, never picks colours, type or illustration style (that is the brand guide's job), never rewrites a hook another skill already chose without saying why, and never puts a figure on a piece without its source.31 32## Use when / not33 34| Situation | Use |35| --- | --- |36| An ad angle, a post or a theme needs a visual piece | this skill |37| A founder post should get an image or a multi-panel version | this skill |38| You don't yet know which angle to run | `ad-themes`, then this skill |39| You need many copy variants within platform limits | `ad-variants` |40| The ads exist and need checking | `ad-creative-critic` |41| You need the buyer's words first | `message-mining` |42 43## Inputs44 45| Input | Required | Ways to provide, in order | If missing |46| --- | --- | --- | --- |47| The source: a theme, a post, or an ad angle (with its hook if one was chosen) | yes | an `ad-themes`, `hook-writer` or `founder-post` handoff; the post or angle pasted | ask once; with none, `BLOCKED` |48| Channel and placement (a LinkedIn or Meta feed, Stories, display, a page hero) | yes | the handoff; the reader's note | ask once; with no answer, `BLOCKED` |49| The goal and the next step (awareness, a click to a page, a reply, a download) | no | the handoff; the reader's note | infer from the channel and source; say so |50| Placement specs (sizes, text limits) | no | the platform's ad specs page, read today; specs the reader pastes | write `confirm` beside each size and limit |51| Brand guide (colours, type, logo rules, illustration style) | no | a file or link the reader shares | the brief says "style: brand guide" and leaves style to the designer |52| Buyer phrases | no | a `message-mining` handoff | use the profile's buying group and messaging house wording |53 54## Profile read55 56From `company-profile.md`: `## Company` (brand terms), `### Buying group` (who the piece speaks to and their objection), `## Buying moments`, `## Messaging house` (the pillar and its proof), `## Voice`, `## Claims and proof` and `### Never say`, `## Competitors` (mention policy), and every `## Learnings` entry for `creative-brief` with status `noted`, `fact` or `accepted` (for example a format or length that worked for this company).57 58No profile: ask in one message for who the piece is for, what the product does, and the figures the company can use in public with their sources. Say that `company-profile` saves this next time. Without approved claims, the piece carries no figures until the reader sources them.59 60## Steps61 621. **Apply learnings.** A learning about formats, lengths or concepts for this company overrides the defaults in `references/formats.md`. Name it when it fires.63 642. **Read the source and write the one message.** From the theme, post or angle, write: the one message in one sentence (if you need 2 sentences, there are 2 pieces); the buyer role it speaks to; the buying moment it meets; the messaging house pillar it serves. If the source carries a hook from `hook-writer` or `ad-themes`, keep it word for word; change it only to fix a failed check, and say which.65 663. **Match the proof.** List every claim the piece would make. For each, find the matching line in `## Claims and proof`.67 68 | The claim | Do this |69 | --- | --- |70 | Matches an approved claim (same figure, same thing, same period) | use it; the source line goes on the piece |71 | Has no match, but a fact about the product could carry it | rewrite it as the mechanism ("reads your CRM stages, never rewrites them"), no figure |72 | Has no match, and the message stands without it | keep it off the piece; list it in open items with the source it needs |73 | Has no match and the message depends on it | stop: `NEEDS DECISION` |74 | Is on `### Never say`, or breaks the competitor mention policy | cut it; if the message depends on it, `NEEDS DECISION` |75 764. **Pick the format.** Use the format table in `references/formats.md`, first match wins. A poll or a video needs the reason written in the brief.77 785. **Pick the visual concept and the panel count.** Use the concept table in `references/formats.md` by the shape of the content. Panels equal the distinct points; never pad or cram. Literal and labelled before metaphor.79 806. **Write the copy.**81 - On-image copy: one line per element in viewing order, never a paragraph. The title stands alone. No label printed twice. Any figure carries its source line on the image.82 - Text around the piece: by placement, from the text table in `references/formats.md`, within the limits from today's spec (or marked `confirm`).83 - Words: buyer phrases from `message-mining` where they exist, the profile's words to use, nothing from words to avoid.84 - Labels on a diagram are claims too: every step, day, stage or figure on a timeline, flowchart or scorecard comes from the source or the profile. Never fill a diagram with steps nobody gave you.85 867. **Write the second execution.** It must change the visual concept, the structure or the title's angle. If the same on-image copy fits both, start again.87 888. **Spec the build.** For each execution: format, size or ratio per placement (from the spec or `confirm`), panel count, what each panel shows, the source line for each figure, alt text (what the image shows, in one sentence, for screen readers), and the style line (from the brand guide, or "style: brand guide").89 909. **Check.** Run the loop below.91 92## Check and verdict93 94The brief's own checks, each pass or fail:95 96| Check | Passes when |97| --- | --- |98| B1 One message | The message is one sentence and every panel serves it |99| B2 Proof attached | Every claim maps to `## Claims and proof` or is a mechanism; every figure has its source line on the piece |100| B3 Format earned | The format matches the table; an exception has its reason written |101| B4 Panels match points | Panel count equals distinct points (plus title and close where shown one at a time) |102| B5 Executions differ | The 2 executions differ in concept, structure or angle |103| B6 Copy rules | Title stands alone; no label printed twice; no paragraph on the image; nothing that blames the buyer |104| B7 Voice | `voice-check` returns PASS or PASS WITH NOTES on all copy |105| B8 Claims | `claim-check` returns PASS or PASS WITH NOTES on all copy |106| B9 Specs | Every size and limit is from today's spec or marked `confirm` |107| B10 Style left to the brand | No colour, type or mood picked unless the brand guide was given |108 109Without `voice-check` and `claim-check` installed, run B7 and B8 inline: no dashes, nothing from `### Words to avoid`, the 3 copy tests (can I picture it, can it be proved wrong, could no one else say it), and every figure traced to a line in `## Claims and proof`.110 111| Verdict | Condition (first match wins) |112| --- | --- |113| `BLOCKED` | No source, or no channel and placement after asking |114| `NEEDS DECISION` | The message depends on a claim with no approved source, or on one the profile forbids |115| `READY WITH OPEN ITEMS` | All checks pass except B9 (sizes to confirm), or a check still fails after 2 rounds and is labelled |116| `READY` | Every check passes |117 118Named stops: `BLOCKED` asks for the missing source or placement. `NEEDS DECISION` shows 2 options and stops: (a) the same piece built on the mechanism instead of the figure, written out; (b) keep the figure once the reader adds its source to `## Claims and proof`. Never invent or borrow a figure to fill the gap. No other stops.119 120## Loop121 1221. Run B1 to B10.1232. Fix each fail: rewrite the line, merge or split panels, change the second execution, or replace a figure with its mechanism.1243. Run the checks again. At most 2 rounds. Anything still failing goes to open items with its check id, and the verdict is `READY WITH OPEN ITEMS`.125 126## Learn127 128Append to `## Learnings` in the profile:129 130- The reader reports how a piece did (saves, click-through rate, cost per lead, replies, from their platform data): a `fact` with the format, the concept, the result and the source.131- The reader overrides a format or concept choice ("our buyers ignore polls"): a `proposal` to change the default for this company.132- A designer sends a brief back as unclear: a `fact` naming the field that was missing.133 134Example: `- 2026-10-24 | creative-brief | fact | 5-panel document posts drew 3x the saves of single images in the company page's feed | Why: the platform's page analytics, Jul to Sep 2026, 12 posts | Status: noted`135 136## Output137 138```139Verdict: <READY | READY WITH OPEN ITEMS | NEEDS DECISION | BLOCKED> · Coverage: <complete | partial (what's missing)>140Learnings applied: <list or none>141 142The one message: <one sentence>143Buyer: <role> · Moment: <buying moment> · Pillar: <pillar> · Goal: <goal> · Channel and placement: <...>144Hook: "<hook>" (<carried from ... | written here>)145 146Proof147| Claim on the piece | Source (from Claims and proof) | Shown as |148 149Execution 1: <name>150Format: <format> (<why>) · Concept: <concept> · Panels: <n> · Size or ratio: <from spec | confirm>151Summary: <the visual idea and its layout in 2 sentences, no colour or style>152On-image copy:153- Title: <line>154- <element>: <line>155Text around it: <hook, beats, close or headline, intro text, button>156Alt text: <one sentence>157Style: <from the brand guide | style: brand guide>158 159Execution 2: <name>160(same fields)161 162Checks: B1 <pass/fail> ... B10 · voice-check <verdict> · claim-check <verdict> (<or: inline>)163Open: <items with check ids>164```165 166Then the handoff block.167 168## Hand off169 170```handoff171skill: creative-brief172version: 1.0.0173verdict: READY174coverage: partial (sizes to confirm on the platform's spec page)175for: <campaign, post or theme>176outputs:177 message: <one sentence>178 format: <format>179 concept: <concept>180 executions: [<name 1>, <name 2>]181 claims: [<approved claim used>]182 landing_page: <URL or none>183next: [ad-creative-critic]184open: [confirm sizes]185```186 187`ad-creative-critic` reads `message`, `claims` and `landing_page` to check the finished ads against the brief. For `NEEDS DECISION`, `next` is `[company-profile]` (to add the source) and `open` names the claim.188 189## Failure modes190 191| Problem | Do this |192| --- | --- |193| The source has 2 or more messages | Write a brief for the strongest one; list the others as separate briefs to make |194| The reader asks for "something eye-catching" with no message | Ask for the one thing the buyer should remember; until then `BLOCKED` |195| The source includes figures from a blog or a report | They are external claims: `claim-check` must open the source; until it does, keep them off the piece |196| 2 rounds of designer feedback miss the same way | Stop guessing: ask the reader to describe what they picture, then rewrite the summary |197| The brand guide asks for a mascot or a style the rules here avoid | The brand guide wins on style; the copy rules still apply |198| The placement isn't known yet | Brief for the format and concept; mark every size and limit `confirm`; verdict `READY WITH OPEN ITEMS` |199 200## Influenced by201 202- SHAKEUP's social pipeline: one message per piece, a default format with earned exceptions, panels that match the points, literal labelled diagrams before metaphor, 2 executions that really differ, and no style choices in the brief.203- Harry Dry's 3 copy tests, used in the copy check: https://www.demandcurve.com/newsletters/growth-newsletter-202