Motion brief writer

SkillAI & models

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.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Motion brief writer skill

What this skill tells your AI

The instructions your AI receives, as published by charlie947/motion-graphics-skills in skills/motion-brief-writer/SKILL.md and read by ahel’s review.

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.

<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>

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.

Signals

GitHub stars
24
Forks
5
Last commit
Sep 2026
Advanced
Item type
skill
Key
motion-brief-writer
Source
github.com/charlie947/motion-graphics-skills