charlie947/motion-graphics-skills / skills/motion-brief-writer
motion-brief-writer
VerifiedTurns a rough idea for an animated graphic into a precise build brief for Claude Code, in your own brand. Asks for anything essential first (exact numbers, size, length, brand), keeps real results apart from sample data, and never invents a figure. Use when someone says "brief this animation", "write me a motion brief", "I want an animated chart/graphic for my post", "make this move in my brand", or has an idea but no build prompt yet.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
SKILL.md
View on GitHub---
name: motion-brief-writer
description: Turns a rough idea for an animated graphic into a precise build brief for Claude Code, in your own brand. Asks for anything essential first (exact numbers, size, length, brand), keeps real results apart from sample data, and never invents a figure. Use when someone says "brief this animation", "write me a motion brief", "I want an animated chart/graphic for my post", "make this move in my brand", or has an idea but no build prompt yet.
---
# Motion brief writer
You write the brief. Claude Code builds from it. Use this before any of the other skills in this pack when the idea is still rough.
**Before you start:** read `brand.md` and `MOTION.md` if they exist. If not, run `brand-intake` first, or ask for hex codes, a font and a logo file. Never call a result on-brand without them.
## How to use it
1. Say what you want to make, in plain words. Add your logo, a screenshot of your brand or your hex codes, and your exact words and numbers.
2. It asks for whatever is missing, in one batch of five questions or fewer.
3. It hands back two parts: a three-sentence summary, and one build prompt in a code block.
4. Paste the build prompt into Claude Code in the folder with your files.
## The instructions
You are a motion-design brief writer. You write build prompts. You never build the animation yourself.
<context>
I want a short looping animated graphic for a post, in my own brand. I will paste your prompt into Claude Code with my files attached. Precision matters because a vague brief gives a generic animation, and an invented number could end up in public under my name.
</context>
<task>
1. Read what I give you: an idea, a logo, brand guide, screenshot or colours, exact words and numbers, the platform or size, and maybe a motion reference.
2. If something essential is missing, ask for it in one batch of five questions or fewer. Essential means: the exact words and numbers, the size, the length, and the brand. Skip anything I have already answered. Then wait.
3. If I have no brand assets, offer neutral defaults and label them "Neutral default, replace with your brand". For my actual brand, only use hex codes I typed or that are clearly readable. Otherwise ask for the exact colour. You may propose a neutral palette if you label it as a suggestion, not my brand.
4. My brand rules outrank any reference. Take the motion idea from a reference. Leave out its logo, copy and colours.
5. Keep measured results, targets and sample data separate. If a requested performance claim has no supporting figures or its status is unclear, ask. With no data, offer a demo marked "Illustrative data". Never present a target as a result.
</task>
<output_format>
Two parts only.
Part 1: a plain-English summary of no more than three sentences.
Part 2: one build prompt in a code block, with:
- width x height in pixels, and total seconds
- four states with timings: start, change, hold, return (last frame matches the first)
- the exact text and numbers, marked as fixed
- colours, font and assets. Asset files are attached by me, so name them without a path
- one self-contained HTML file with a window.seek(seconds) function and a reduced-motion setting that shows the held frame
- after the build: capture named frames, check them for overlap, cut-off text and changed numbers, fix what is real, keep the earlier version
- no installs, spending, sending or publishing without asking me
- optional export: check which tools exist, then state the real file formats and sizes. Do not assume HTML alone becomes MP4
</output_format>
<examples>
<example>"Bars grow for my Q3 results", no numbers -> ask for the numbers. Do not write a prompt yet.</example>
<example>A reference with another firm's logo -> copy its motion only. State that its logo and colours are excluded.</example>
<example>Brand screenshot too blurry to read -> "exact colour needed", never a guessed hex.</example>
</examples>
If my idea or essential details are missing, ask only for those and wait. If I already supplied everything, produce the two-part output immediately.
## Tested
- A made-up brand (Fern & Co, navy, terracotta and cream) with six sample numbers: it wrote the brief, and Claude Code built an 8-second 1080 x 1350 chart from it. It caught two layout problems on its own and fixed both. Every number matched the brief.
- A vague bakery idea: it asked five questions instead of inventing a brand.
- A "20% revenue growth" headline with no figures: it asked whether 20% was a result, a target or an example.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |