scaefy-video-production

Scaefy Video Production

English · Türkçe

A code-generated video production skill pack — engine-neutral, free at its core, and gated by measurements instead of opinions.

Your coding agent writes the film as code. A timeline renders every frame as a pure function of time, stills are captured from a real browser, ffmpeg encodes, audio is mixed, and the delivery passes a quality gate that fails loudly. No timeline editor, no keyframe dragging, no "looks good to me".

v0.1.0 — 10 skills, a dependency-free 30-second example film verified in a real browser, and a CI pipeline that runs every gate on each push. GitLab (primary) · GitHub (mirror)

---

See it work

example/ holds a complete 30-second, 1920x1080, 25 fps film — a real one, built for the agency that maintains this pack. It has zero dependencies: open example/index.html in a browser and it plays. No build step, no package install, no network.

# watch it
open example/index.html

# capture stills and measure them
PUPPETEER_CACHE_DIR="$PWD/.puppeteer-cache" TMPDIR="$PWD/.tmp" \
URL="file://$PWD/example/index.html?clean=1" \
node tools/shots.mjs shots 2 6 12 18 24 28
python3 tools/check-frames.py shots/*.png --theme light

# measure every text box against the safe area, from the DOM
PUPPETEER_CACHE_DIR="$PWD/.puppeteer-cache" TMPDIR="$PWD/.tmp" \
node tools/probe-layout.mjs --safe 0.08 --url "file://$PWD/example/index.html?clean=1" 2 6 12 18 24 28

The film's on-screen copy is Turkish and its English subtitles ship alongside it, because the brand it was made for is Turkish. The pack's own prose is English.

---

Why this exists

Most "AI video" tooling ties you to one engine, one provider, or a heavy framework. This pack makes three commitments instead:

1. Engine-neutral. A film is built with one engine — HTML + GSAP for one-shot work that needs fast iteration, Remotion for data-fed templates that get re-rendered, or AI generation for photoreal footage. The pack teaches all three and never mixes them inside a single film.
2. Free and offline at the core. The default pipeline needs no API key, no account, and no network. AI footage is an optional layer you can add, skip, or run locally.
3. Gated by measurements. Loudness, true peak, frame integrity, safe-area overflow, and determinism are checked by scripts that return a non-zero exit code — not by a paragraph asking you to be careful.

---

The zero-cost guarantee

Layer B has three paths, and you choose:

If a brief needs AI footage and you have neither a GPU nor a quota, the agent falls back to Layer A and says so — it never silently connects to a paid service.

---

Quick start

Requirements: Node 18+, Python 3.10+, ffmpeg. All local, all free.

git clone <this-repo>
cd scaefy-video-production

# Resolve a working ffmpeg (tests execution, not existence)
FF="$(tools/ffmpeg.sh)" && echo "ffmpeg OK"

# Run every quality gate
bash tools/verify.sh

To install as a DSH agent preset:

mkdir -p ~/.dsh/.agent-presets
cp -R . ~/.dsh/.agent-presets/scaefy-video-production

To use the skills with any agent that supports the Agent Skills standard:

npx skills add <this-repo>

---

Try these prompts

Paste any of these into your agent. Each one is phrased the way a person actually talks, not the way a manual reads — the skill descriptions are written to catch them.

Plan before spending. The cheapest thing you can change is the edit.

Plan a 30-second launch video for our homepage. Give me a brief and a timed animatic first — do not render anything until I approve the pacing.

Turn a site into a film.

Turn this landing page into a 20-second tour that uses the site's own visuals.

Make a vertical cut that isn't a crop.

There's a finished master in out/. Give me a 15-second 9:16 version. Recomp it for portrait — if you can't tell me what a centre crop would cut off, you haven't checked it.

Keep a character consistent across shots.

Here are four product stills. Write me a look bible and show me the stills before you generate any video from them.

Fix the sound, then prove it.

The music is fighting the narration. Duck it under speech and hit −14 LUFS integrated with true peak under −1 dBTP, then show me the measurement.

Captions that survive a muted feed.

Add English subtitles and tell me the reading speed of every cue. Nothing above 17 characters per second.

Just tell me what's wrong with this file.

QC out/final.mp4 against the 1080p delivery spec and list what fails.

More than one language.

Take the Turkish film and give me an English-subtitled version without touching the master.

What makes these prompts work

The pack's skills route on triggers, not on exact wording. You do not need to name a skill. But three habits get better results:

• Ask for the cheap artifact first. "Brief and animatic before you render" costs minutes instead of hours when the plan is wrong.
• Ask for the measurement. "Show me the number" turns an opinion into a check, and qc.py already produces it.
• State the constraint, not the method. "Recomp it, don't crop it" gets you a designed portrait version; "make it vertical" gets you a centre crop.

---

Skills

First-party

Vendored (MIT, attributed — see THIRD_PARTY_NOTICES.md)

---

Tooling

The frame tools measure what is measurable and leave taste to a human. The layout probe reads Range.getClientRects() so it reports actual ink bounds regardless of alignment.

---

Delivery matrix

Colour space Rec.709 / Gamma 2.4. Audio AAC 48 kHz, 320 kbps stereo. Loudness target −14 LUFS integrated, true peak ≤ −1 dBTP.

---

Related work

This pack is deliberately lightweight and permissively licensed. These projects solve adjacent problems and are worth your attention:

• OpenMontage — a batteries-included agentic video production framework (Python, 100+ tools, 60+ providers), licensed AGPLv3. Its free path — offline Piper TTS, open archival footage, local GPU generation — independently validates the architecture this pack is built on. It is not a dependency and no code is shared: AGPL and MIT works stay separate.
• sub-level/marketing-videos — an MIT Remotion + AI-footage pipeline with excellent case studies.
• pexoai/pexo-skills — MIT skills wrapping a multi-model cloud generation API.
• seedance2-skill — MIT prompt-writing guide for Seedance 2.0, by Dex.

---

License

MIT — see LICENSE. Vendored third-party skills keep their own MIT licences and attribution; see THIRD_PARTY_NOTICES.md.