motion-brief-writer

Q: How do I install motion-brief-writer?

Run npx skills add https://github.com/charlie947/motion-graphics-skills --skill motion-brief-writer 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/motion-brief-writer/ (personal) or .claude/skills/motion-brief-writer/ (project).

by charlie947Docs & Writing

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.

Installs: 1.5K
Last 24h: +64
Trending rank: #2822
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/charlie947/motion-graphics-skills --skill motion-brief-writer

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 motion-brief-writer 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.

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

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.
It asks for whatever is missing, in one batch of five questions or fewer.
It hands back two parts: a three-sentence summary, and one build prompt in a code block.
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.

FAQ

What does the motion-brief-writer skill do?

How do I install motion-brief-writer?

Run npx skills add https://github.com/charlie947/motion-graphics-skills --skill motion-brief-writer 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/motion-brief-writer/ (personal) or .claude/skills/motion-brief-writer/ (project).

Which AI agents can use motion-brief-writer?

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 motion-brief-writer 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 motion-brief-writer?

It is published by charlie947 in charlie947/motion-graphics-skills. It has 1,544 recorded installs.