code-brand-film
Produce a short brand film or product promo (10-60s, typically 15s) entirely as code: one static HTML page with a paused GSAP timeline that a renderer seeks frame by frame, plus a music score synthesized in Python. Use when the user wants a 品牌宣传片, 广告片, 宣传动画, 产品短片, 发布会开场视频, brand film, promo video, product teaser, logo animation, or a generated ad spot — especially when they ask for 高级感 / 艺术感 / 电影感 / 别像模板, or when an existing video "looks like AI made it" or "too simple" and needs to be redone properly. Also use when a film already exists and needs a score, a soundtrack, background music, or 配乐, or when a code-generated video needs ghosting, contrast, font, or transition defects fixed.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/nutllwhy--code-brand-film)HTML
<a href="/listings/nutllwhy--code-brand-film"><img src="/api/listings/nutllwhy--code-brand-film/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 228 lines
- ---
- name: code-brand-film
- description: >
- Produce a short brand film or product promo (10-60s, typically 15s) entirely
- as code: one static HTML page with a paused GSAP timeline that a renderer seeks
- frame by frame, plus a music score synthesized in Python. Use when the user
- wants a 品牌宣传片, 广告片, 宣传动画, 产品短片, 发布会开场视频, brand
- film, promo video, product teaser, logo animation, or a generated ad spot —
- especially when they ask for 高级感 / 艺术感 / 电影感 / 别像模板, or when an
- existing video "looks like AI made it" or "too simple" and needs to be redone
- properly. Also use when a film already exists and needs a score, a soundtrack,
- background music, or 配乐, or when a code-generated video needs ghosting,
- contrast, font, or transition defects fixed.
- metadata:
- category: media
- ---
- # Code-generated brand films
- > **Three things decide whether a film ships. Do not skip any of them.**
- > 1. Read *all ten* files in the reading table below, plus the example's
- > `src/index.tpl.html`. Reading only `creative.md` / `pipeline.md` /
- > `scoring.md` reproduces the rejected films described here.
- > 2. Search for the brand's real logo and imagery and record them in
- > `assets.md`, then write `shot-list.md` and `copy.md` — all before the timeline.
- > 3. Run all three gates and paste their output in your delivery:
- > `scripts/film_audit.py film/index.html` before rendering,
- > `node scripts/layout_audit.mjs film/index.html` before rendering,
- > `scripts/frame_audit.py film/renders/silent.mp4` after.
- > All three print `0 failed`, or the film is not delivered. Lint passing means
- > the page is valid, not that the film is good.
- A film is one static HTML page inside `film/`, driven by a paused GSAP timeline
- that the renderer ([HyperFrames](https://github.com/heygen-com/hyperframes))
- seeks frame by frame. Every asset is a local file. The score is a separate Python
- program that writes a WAV, muxed onto the silent picture at the end.
- ## The failure this skill exists to prevent
- The usual failure is not a broken film, it's an **under-built** one: it lints
- clean, has no bad frames, and still looks like a template. A real example built
- from an earlier version of this skill had 18 tweens, one entrance mechanic
- (fade + slide), only crossfades between acts, a logo redrawn as a circle,
- system fonts, a tagline nobody had written, and no product on screen. The two
- accepted films it was compared against had ~105 tweens, 9–12 mechanics, 2–4
- non-crossfade transitions, and showed the product working in most acts.
- So this skill sets **floors you can measure** and gives you **code to copy**.
- There are three gates: `scripts/film_audit.py` on the HTML (floors),
- `scripts/layout_audit.mjs` on the HTML in a real browser (placement), and
- `scripts/frame_audit.py` on the rendered MP4 (pixels). All must print `0 failed`.
- A later film passed the first and last and was still rejected for placement:
- headline under the input bar, logo on the first character, a notification card
- parked on the corner mark. The layout gate exists for that.
- **The floors are minimums, not targets.** A later film cleared the code gate at
- exactly 70 tweens and 8 mechanics, padded with breathing headlines, and was still
- an abstract ink-drop animation covering 3% of the frame with no product in it.
- The tween count now excludes filler, and the pixel gate exists because pixels
- cannot be padded. If you find yourself adding tweens to pass a number, stop: the
- film is missing content, not motion. Aim at the reference example, not the floor.
- A third film came from an agent that read only `creative.md`, `pipeline.md`
- and `scoring.md`, never ran either gate, and "fixed the single worst frame"
- on a picture that was mostly empty. Metaphor: a stone thrown into a lake,
- ripples growing six glowing icons on a dark purple void. It linted with
- 0 errors and had a loudness-matched score. It also had 36 tweens, 3 mechanics,
- no logo, no shot list, 1.3% of the frame covered and a 4.4s still stretch:
- 13 failed checks. Everything it needed to avoid that was in the files it
- didn't open.
- A fourth film followed every step, passed all three gates (109 tweens, 10
- mechanics) and still lost clearly to a film of the same product that would have
- *failed* the old floors. The brand had shipped its own product animations; the
- losing film used three of them, held two still photos for six seconds under
- focus brackets and capture rings, put grain over the brand's white sweep, and
- changed acts with a different trick every time. The winner cut seven official
- clips on a stage sampled to their exact ground, drew nothing on the product,
- and used one transition taken from the product's hinge on every act change.
- When the brand ships motion, read `references/footage-led.md` — the audit
- switches to its floors automatically.
- ## Read these — in this order
- | Step | File | Why |
- | --- | --- | --- |
- | before anything | [references/creative.md](references/creative.md) | metaphor, five-act timing, motion rules, palettes, the AI-look traps |
- | before placing anything | [references/layout.md](references/layout.md) | zone map per act, hard placement rules (text never covered, logo never on text, title safe, no half-parked cards) |
- | before anything | [references/assets.md](references/assets.md) | where to search for the real logo and imagery, the five-point logo check, the `assets.md` manifest |
- | before anything | [references/quality-bar.md](references/quality-bar.md) | the numbers, the mechanic list, the transition list, product truth, real assets |
- | if the brand has product video | [references/footage-led.md](references/footage-led.md) | footage-led films: harvest the motion, stage = studio ground, no texture, one signature transition from the product's shape, draw nothing on the product, localised copy |
- | before coding | [references/shot-list.md](references/shot-list.md) | the table you fill in first; worked example included |
- | while coding | [references/recipes.md](references/recipes.md) | copyable GSAP for 27 mechanics and transitions (24–27: fold on a seam, seam open, anchor match cut, pose burst) |
- | while coding | [examples/office-agent/](examples/office-agent/) | a complete 400-line film that clears every floor — read its timeline |
- | scaffold / render | [references/pipeline.md](references/pipeline.md) | layout, template+build, lint warnings, macOS pitfalls, defect checklist |
- | music | [references/scoring.md](references/scoring.md) | beat grid from picture, energy plan, mix graph, verify without ears |
- Do read the example's `src/index.tpl.html` end to end before writing your own.
- Seeing how much one 15s film contains is worth more than any rule here.
- ## Workflow
- 1. **Collect sources.** Brief or product page: the mandatory selling line, 3–5
- concrete product behaviours, required copy and CTA, red lines.
- **Then go searching** (`references/assets.md`): user-supplied files → press /
- brand kit → official site (header SVG, og:image, screenshots) → app store
- listing → official social posts. Bring back the current logo and ≥ 2 official
- images, at least one showing the real product. Run the five-point logo check
- (right product, current version, right variant, untouched, resolution) and
- write it all into `assets.md` with source URLs. Never redraw a logo, never
- take one from a logo-aggregator site. Start with
- `scripts/harvest_page_images.py <product-page> --video` — it pulls every
- image, SVG and product clip the page uses and makes numbered contact sheets
- to pick from. Harvest the country page in the audience's language too; copy
- comes from there. **Clips found?** The film is footage-led
- (`references/footage-led.md`): footage carries acts 2–4, stills only as a
- burst, stage colour = the clips' sampled ground.
- **Physical product?** It appears as its official photo every time it is on
- screen; acts 2–4 show its *output* through its own UI, and each feature line
- gets a proof shot (`creative.md` example C, `recipes.md` 20–23).
- 2. **Find the metaphor** — one sentence with a physical verb, ideally taken
- from the brand's own asset or the selling line's own words (`creative.md`).
- 3. **Write `shot-list.md` and `copy.md`** in the film project (next to `film/`;
- the audit fails without them). `copy.md` lists every on-screen line with its
- source; see `examples/office-agent/copy.md`. Shot list from the template. Every act:
- ≥ 5 timed events, a named camera move, a named exit transition, three depth
- layers, a product behaviour (except hook/lockup), and a source for each line
- of copy. Run the self-check at its bottom. If the user is around, show it.
- 4. **Scaffold.** `film/hyperframes.json` (copy `assets/hyperframes.json`),
- `film/package.json` pinning `hyperframes@0.8.78`, `src/index.tpl.html`,
- `src/build.py` (copy `scripts/build_template.py`). Start from the example's
- texture layer (grain, falloff) — except in a footage-led film, where texture
- over the brand's studio ground is a fail. Do **not** add a page counter (`02 / 05`),
- a progress bar or corner labels — they make the film look like slides.
- 5. **Fonts.** `python3 src/build.py`, then
- `scripts/fetch_cjk_fonts.sh src/chars.txt film/assets/fonts` for Chinese.
- Latin fonts: download woff2 files into `film/assets/fonts/`. Every
- `@font-face` uses `url()` to a local file; `local()` is not allowed.
- 6. **Author** the timeline act by act from the shot list, pulling mechanics from
- `recipes.md`. Run `npx --yes hyperframes@0.8.78 lint` after each act.
- 7. **Gate.** `python3 scripts/film_audit.py film/index.html` → must print
- `0 failed`. Fix every FAIL by adding real content, not by gaming the regex.
- Then `node scripts/layout_audit.mjs film/index.html --shots .gates/layout`
- → must print `0 failed`. Open the screenshots, move things per
- `references/layout.md`, re-run.
- 8. **Render silent**, then `python3 scripts/frame_audit.py film/renders/silent.mp4`
- → must print `0 failed`. Make a contact sheet and put it next to
- `examples/office-agent/reference-sheet.jpg`; answer the three comparison
- questions in `quality-bar.md`. If yours is clearly thinner, go back to step 6
- — add product on screen, not decoration. Then fix the single worst frame.
- 9. **Score it — only now, after all three gates pass.** `score_lib` prints a
- NOT READY banner if `.gates/` is missing any of the three pass stamps.
- (`scripts/score_template.py` → `audio/score.py`), mix SFX,
- `loudnorm` to −14 LUFS, mux with `-c:v copy`.
- 10. **Deliver** one `MEDIA:`/file line per output. State what you verified
- (both audits' numbers, lint, loudness, the reference comparison) and what only the user can judge
- (taste, how the music sounds). Flag any invented copy and any low-res logo.
- ## Commands
- ```bash
- python3 src/build.py
- python3 <skill>/scripts/film_audit.py film/index.html # code gate: must be "0 failed"
- node <skill>/scripts/layout_audit.mjs film/index.html --shots .gates/layout # placement gate: "0 failed"
- cd film
- npx --yes hyperframes@0.8.78 lint # target 0 errors; read every warning
- PRODUCER_BROWSER_GPU_MODE=hardware \
- npx --yes hyperframes@0.8.78 render . -q high --fps 30 -o ./renders/silent.mp4
- python3 <skill>/scripts/frame_audit.py renders/silent.mp4 # pixel gate: must be "0 failed"
- <skill>/scripts/review_frames.sh renders/silent.mp4 snapshots 2 "11.0,13.5"
- ```
- ## Hard rules (each one came from a rejected or broken film)
- - **Floors are floors, not targets.** ≥ 90 non-filler tweens, ≥ 8 mechanics, ≥ 2 non-crossfade
- transitions, ≥ 8 eases, ≥ 8 camera moves, ≥ 5 events in every act (15s film).
- - **Show the product working** in at least two acts — its interface, its
- output, a device running it, real-looking data. An abstract metaphor (ink,
- particles, light, a seed growing) with no product in it could be an ad for
- anything and is rejected even if every number passes.
- - **Fill the frame.** A line of text and one small shape on a flat ground is an
- empty frame. Every act needs background, midground and foreground layers.
- - **Copy comes from the source.** Every on-screen line traces to the brief or the
- product page; anything invented is flagged to the user.
- - **Real logo, real imagery, real fonts.** The brand's current logo file for this
- exact product, checked against the live site and app store; ≥ 2 official images
- used as material (screens, masks, key visuals); every file sourced in
- `assets.md`; embedded woff2 subsets. A logo "inspired by" the brand, or the
- parent app's favicon standing in for a sub-product, is a wrong logo.
- - **When the brand ships motion, cut it; don't decorate it.** Footage on a
- stage of its own sampled ground colour, no grain over it, no focus brackets /
- rings / cursors drawn on the product, one signature transition from the
- product's own shape on ≥ 3 act changes, every product shot anchored to the
- same screen line, copy from the brand's page in the audience's language.
- - **The logo lives in the lockup, nowhere else.** No corner mark through the
- film (the layout gate fails it). The last frame is one group on the product's
- axis; never add your own title next to an official frame that already has
- type in it, never let the product cross the type, never `contain` a
- non-16:9 still so it floats in bars (`references/layout.md`, "The last frame").
- - **No template look.** No beige/orange-pink lifestyle palettes, no centring
- everything, no equal-length acts doing the same thing. The accent colour is a
- highlight, not a ground.
- - **One pull-back per film.** It reads as "this is ending".
- - **Motion lives on `.cam` layers**; initial hidden state lives in CSS; never
- fade an element that also has its own opacity tween. (Ghosting.)
- - **No `Math.random()` in the timeline** — frames are seeked out of order.
- - **Ship it with music**, landing the final hit on a downbeat. A brand film with
- no score is an incomplete delivery.
- - **Verify honestly.** You cannot hear audio or watch motion in real time; report
- the checks you ran, not a feeling.
- - **Client work gets reviewed before publishing.** Say so in the delivery.
- ## Bundled resources
- ```
- scripts/film_audit.py code gate, before render (floors, shot list, copy and asset sources)
- scripts/layout_audit.mjs placement gate, headless Chrome (hidden / colliding / clipped text, safe area, half-parked cards, corner logos)
- scripts/frame_audit.py pixel gate, after render (coverage, detail, motion)
- scripts/harvest_page_images.py every image (and with --video every product clip) on an official page → index.tsv + contact sheets
- scripts/fetch_cjk_fonts.sh Noto Serif/Sans SC subsets for exactly the characters used
- scripts/build_template.py template → film/index.html + CJK character list
- scripts/review_frames.sh render → contact sheet + stills + duration check
- scripts/score_lib.py instrument library + reverb + master (import, don't edit)
- scripts/score_template.py five-act arrangement to copy and fill in
- assets/hyperframes.json project config
- examples/office-agent/ complete reference film (placeholder brand), with its
- shot-list.md, copy.md and reference-sheet.jpg
- ```
README.md · README · 16 lines
- # code-brand-film
- 用代码做 15 秒品牌宣传片的 Agent Skill:画面是一页 HTML,用暂停状态的 GSAP 时间轴驱动,由 [HyperFrames](https://github.com/heygen-com/hyperframes) 逐帧渲染;配乐是用 Python 合成的原创曲,节拍跟着画面的切点走。
- - `SKILL.md`:工作流程和交付标准
- - `references/`:创作方法、质量门槛、动效配方、分镜表、工程管线、配乐
- - `scripts/`:三道质量闸门(`film_audit.py` 查代码,`layout_audit.mjs` 在浏览器里逐帧查摆位,`frame_audit.py` 查渲染出的画面)、乐器库、配乐模板、构建模板、审帧脚本
- - `examples/office-agent/`:一条完整可渲染的参考片,附分镜表、文案出处表和联系表
- 用法要点:先填 `shot-list.md` 和 `copy.md` 再写代码;两道闸门都 `0 failed` 才算能交付。门槛是下限,不是目标。
- 依赖:Node 22+、ffmpeg、Python 3 + numpy、Chrome + puppeteer-core(摆位闸门用,`npm i puppeteer-core`)。
- ## 许可证
- 代码与文档以 [MIT 协议](LICENSE) 开源。示例里的 Noto 字体(SIL OFL 1.1)、GSAP 等第三方内容保留各自的许可证,见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。用本 skill 做片时收集的品牌 logo、产品图和官方视频归品牌方所有,商用前请确认授权。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.