/brag — Turn Your Project into a Launch Video
A Claude Code skill that turns any project into a short, polished, shareable launch video with music, motion, and share copy. One command reads your project code, plans a creative angle, storyboards the video, and renders it via Hyperframes.
Spec
/brag — Turn Your Project into a Launch Video
You built it. Now brag.
/brag turns the current project website or app into a short, polished, shareable launch video using Hyperframes. It is narrow, opinionated, and fun.
What this skill does
- Reads the current project code to understand the app.
- Plans a short brag concept specific to this project.
- Scripts and storyboards the video.
- Hands a focused composition brief to Hyperframes.
- Validates, renders, and writes share copy.
Parsing the invocation
The user may invoke with natural language or flags:
/brag
/brag --tone chaotic
/brag --tone polished --format vertical
/brag this. Make it feel like a ridiculous startup launch.
Parse these options:
| Option | Values | Default |
|---|---|---|
| --tone | preset or freeform description | inferred |
| --format | landscape, vertical, square | landscape |
| --duration | seconds | auto (15-25s) |
| --no-music | flag | music on |
| --no-sfx | flag | sfx on |
| --title | string | inferred from project |
Tone can be a preset (default, polished, yc-parody, chaotic, deadpan, cinematic, app-store) or a creative direction such as "fake Series A launch from 2016".
Output directory
By default, output goes to brag-output/. To avoid overwriting previous runs, use a timestamped directory.
Step 1: Inspect the project
Scan the project directory and extract the information needed to plan the brag video.
Gate: You can answer all 9 questions in the brag planning rubric.
Step 2: Plan and storyboard
Write <output-dir>/brag-plan.md. Answer the planning rubric. Commit to a creative angle. Write the beat-by-beat storyboard including scenes, text, timing, transitions, and SFX cues.
Gate: <output-dir>/brag-plan.md exists with a full storyboard. Scene durations sum to 15–25 seconds.
Step 3: Hand off to Hyperframes
Write the composition brief and use Hyperframes to create the video implementation in <output-dir>/composition/.
/brag owns the product angle, source material, storyboard, tone, format, audio selection, and delivery expectations. Hyperframes owns the concrete composition structure, animation timing, and render workflow.
Gate: npx hyperframes lint passes with zero errors.
Step 4: Validate, render, and deliver
Validate, preview, render to <output-dir>/brag.mp4, and write <output-dir>/share-copy.txt.
Gate: <output-dir>/brag.mp4 exists. Share copy is written.
Tone system
| Tone | Energy | One-liner |
|---|---|---|
| default | Playful, clean, postable | The good-vibes default |
| polished | Serious, elegant | For projects that are not jokes |
| yc-parody | Deadpan startup energy | Fake seriousness applied to absurd projects |
| chaotic | Fast, loud, aggressive | Over-the-top and unhinged |
| deadpan | Calm, dry, understated | The joke is that nothing is a joke |
| cinematic | Dramatic, trailer-scale | Big motion, bigger claims |
| app-store | Smooth, feature-card clean | Corporate but not boring |
Creative laws
- Short. 15–25 seconds. Not one second more without a reason.
- Readable. Keep the pace high through motion and cuts, never by flashing text.
- Specific. The video must feel like it was made for this exact project.
- Show the thing. At least one scene must display actual UI, copy, or a key visual from the product.
- No generic SaaS language. Use the project's actual copy and claims.
- The hook is everything. The first 2 seconds determine whether someone keeps watching.
- Funny earns its place. Humor should come from the project's absurdity.
Pattern: Hook (2-3s) → Reveal (2-4s) → 2-3 sharp highlights (5-12s) → Punchline/outro (2-4s)
Requirements
- Claude Code (with skill/plugin support)
- Node.js 22+
- FFmpeg on
PATH - Hyperframes CLI —
npx hyperframes
