saas-motion-video
Make a promo / motion video for a software product with HyperFrames, using the saas-motion-kit 7-stage process (brief → components → theme → storyboard → build → sound → deliver), the clean-or-imaginary component rule, the creative muscle (tone matrix, variety rules, component forge, transition atlas, variety audit) and the 101-theme gallery in docs/. Use when someone asks for a launch video, product promo, booth loop, feature reveal or social motion piece for an app, SaaS or developer tool.
How do I install this agent skill?
npx skills add https://github.com/tugrawork-creator/saas-motion-kit --skill saas-motion-videoIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill automates a multi-stage video production workflow using a combination of local scripts and the HyperFrames toolkit. It interacts with external URLs and documents provided by the user and maintains a local history file in the user's home directory to ensure creative variety across projects. Potential risks are limited to processing untrusted external content and standard command execution of included utility scripts.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
saas-motion-video
You are the producer. The user is the creative director. Run the stages in order and stop at every gate for a human decision. Keep the user's taste in the loop; that is what makes the film feel human-made.
The one rule of this kit: no two films should feel like the same film. Don't repeat effects, transitions or components (within the film, or from the user's recent films). Invent at least one new component per film. Decide the message and the tone before choosing any effect. Read creative/README.md before stage 4.
Before starting
- The HyperFrames skills must be installed (
npx skills add heygen-com/hyperframes). If/hyperframesis not available, ask the user to install them and restart the session. - Read
playbook/README.md. Read each stage file when you reach that stage.
Stages
- Brief (
playbook/01-brief.md). Ask at most four questions: the one message, the channel/format, the sound (music, SFX, voice or silent) and the truth source (a URL or docs). Also ask whether they have reference videos they love. For each one, runpython tools/breakdown.py <video> --id NN --creator … --url …and credit it inREFERENCES.md(templates/REFERENCES.md,creative/references.md): borrow grammar, never assets. WriteBRIEF.mdfromtemplates/BRIEF.md. Gate: the user confirms the brief. - Components (
playbook/02-components.md,components/README.md). If there is a URL, runnpx hyperframes capture. Score the real UI and propose, per component, real or imaginary. Never invent capabilities, customers or statistics. Gate: the user approves the inventory. - Theme (
playbook/03-theme.md). Suggest 2–3 themes fromdocs/themes/data/*.jsonthat fit the audience (read theirsummary,fitandbest_for). Start frompython tools/pick_themes.py --tone <the brief's tone> --audience "<audience words>" --history ~/.motion-ledger.json, which skips the themes of the user's last five films. Redraw each candidate's proof-moment frame in the user's brand as a quick HTML still. Gate: the user picks one. - Storyboard + creative pass (
playbook/04-storyboard.md,creative/). WriteSTORYBOARD.mdfromtemplates/STORYBOARD.md: first the Message & tone sentence ("I want to say ___ in a ___ tone, so the viewer feels ___"), then the ledger (one row per shot: entrance, transition, ease, direction, palette, camera, components, new component, sfx, notes), then the frames. Choose craft fromcreative/tone-matrix.md, transitions fromcreative/transition-atlas.md(plus HyperFrames' stock set), and forge at least one new component withcreative/component-forge.md. Runpython tools/variety_audit.py STORYBOARD.md --history ~/.motion-ledger.jsonand fix every warning, or mark a deliberate repeat asmotif:. Then draw a one-page sketch sheet. Keep on-screen words to a minimum. Gate: the audit is clean (or every remaining warning is explained), and the stills read as a story with the sound off. - Build (
playbook/05-build.md). Hand off to the HyperFrames workflow (/product-launch-videofor a URL-driven promo,/general-videofor loops and custom pieces). Keep every frame seek-safe and deterministic. Runlint,snapshotandcheck. Gate: the user approves the preview. - Sound (
playbook/06-sound.md). Music-driven: build a beat grid first and cut on bars. SFX: use warm tuned timbres (tools/warm_sfx.py). Silent is a valid choice. Gate: the user approves the mix. - Deliver (
playbook/07-deliver.md). Render at 4K, then runtools/deliver.shto downscale. For loops, runtools/loop_check.py. Report the actual duration, size and path. Record the film so the next one avoids it:python tools/variety_audit.py STORYBOARD.md --history ~/.motion-ledger.json --append "<film>" --theme <NNN>. Every few films, offerpython tools/history_report.py ~/.motion-ledger.json -o motion-history.htmlso the user can see what they keep reaching for. Gate: the user checks it on the target screen.
Hard rules
- Official logos only. Never redraw a brand mark.
- For non-Latin characters, bundle
latin-extfont subsets locally. Write uppercase text yourself instead of relying on CSStext-transform(which breaks Turkish i/İ). - No progress bars, no gradient text, no pure #000/#fff, no bounce or elastic easing on UI.
- Fewer words. If the story needs reading, redesign the frame.
- Credit every reference video by name and link (
REFERENCES.mdandref:<id>in the ledger; the audit enforces it). Never put someone else's footage, frames or music in a film or the repo. - Every transition must answer "why this one, here?". No transition twice in a row, at least three transition families, one surprise every ~15 s.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tugrawork-creator/saas-motion-kit/saas-motion-video">View saas-motion-video on skillZs</a>