Menu
Assemble a narrated video from a TOML project file using the committed assembler script. Use when the user says /assemble-video and provides an android.toml or ios.toml path, or wants to generate audio for the audio-first workflow.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Planner-Generator-Evaluator harness for large, multi-screen features or major refactors. Separates planning, implementation, and evaluation into distinct phases with isolated context, preventing self-grading bias and context drift. Use when the user asks to build a large feature, do a major refactor, or implement something spanning multiple screens/files.
Unified release for both Android and iOS from a single version tag. Runs quality gates, bumps both platform versions in one commit, tags, builds both platforms, uploads Android to Play Store, and opens iOS archive for App Store upload. Use when the user asks to release, ship, cut a release, or make a new version.
Build and upload an Android release based on an existing git tag. Runs lint and all tests first (unit and instrumented), bumps version to match the tag, builds release AAB and APK (without debug info), commits the version bump, and uploads the AAB to Google Play Store internal testing. Use when the user asks to make an Android release, build for Play Store, or upload to Google Play.
Create a GitHub release with a version tag and auto-generated release notes. Does not build artifacts or upload to any store. Use when the user asks to tag a version, create a GitHub release, cut a release, or prepare release notes.
Build an iOS release based on an existing git tag. Bumps version to match the tag, builds the shared KMP framework and the iOS app archive. Use when the user asks to make an iOS release, build for App Store, or create an iOS archive.
Add translated strings and plurals to Android and iOS locale files. Use when adding new user-facing strings or plurals, fixing MissingTranslation lint errors, or when the user asks to translate, localize, or add strings to all languages.
| name | assemble-video |
| description | Assemble a narrated video from a TOML project file using the committed assembler script. Use when the user says /assemble-video and provides an android.toml or ios.toml path, or wants to generate audio for the audio-first workflow. |
Runs scripts/assemble_video.py to assemble per-scene video clips with AI-generated voiceover narration and branding jingles into a final MP4.
ffmpeg on PATHtomllib)OPENAI_API_KEY in ~/.secretspip install openai/record-clips to create them)source ~/.secrets
python3 scripts/assemble_video.py docs/videos/<feature>/android.toml
Replace android.toml with ios.toml for iOS videos.
The script:
tpad to match narration durationconcat filterGenerate audio first to know exact clip durations before recording:
# Step 1: Generate audio, print required clip durations
source ~/.secrets
python3 scripts/assemble_video.py docs/videos/<feature>/android.toml --audio-only
# Step 2: Record clips using the printed durations
# Use /record-clips skill
# Step 3: Assemble final video
python3 scripts/assemble_video.py docs/videos/<feature>/android.toml
Each feature has per-platform TOML files in docs/videos/<feature>/:
android.toml -- Android-specific scenes, recording notes, and resolutionios.toml -- iOS-specific scenes, recording notes, and resolutionAudio (audio/ directory) is shared across platforms since narration is platform-agnostic.
[project]
title = "Feature Name - Ukulele Companion"
output = "../../feature-videos/android/feature-name.mp4"
resolution = "1080x2424"
[branding]
intro = "../../jingle-intro.wav"
outro = "../../jingle-outro.wav"
[voiceover]
model = "tts-1-hd"
voice = "nova"
volume_boost = 3.0
[[scene]]
name = "scene-name"
video = "clips/android/01-scene.mp4"
audio = "audio/01-scene.mp3"
narration = """Narration text."""
delay = 1.0
min_clip_duration = 25
See existing projects at docs/videos/explorer/android.toml and docs/videos/tuner/android.toml for full examples.
mkdir -p docs/videos/<feature>/clips/android docs/videos/<feature>/clips/ios docs/videos/<feature>/audioandroid.toml (and/or ios.toml) with scenes and narration--audio-only to generate audio and see required clip durations/record-clips to record scene clips/record-clips -- Record scene clips for a TOML project