You built it. Now brag. Turn the project you just created into a short, shareable launch video with one command.
fix: use <output-dir> in every step reference so timestamped runs don't overwrite (#20)
ShantanuTaro1ada6934ddee
diff --git a/skills/brag/SKILL.md b/skills/brag/SKILL.mdindex 95d580e..34adb74 100644--- a/skills/brag/SKILL.md+++ b/skills/brag/SKILL.md@@ -49,7 +49,7 @@ Parse these options:Voice is opt-in. If `--voice` is present, use Kokoro via Hyperframes and donot add any provider-selection logic. The voice workflow is intentionally-single-provider in this PR.+single-provider.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", "museum exhibit", or "overproduced mobile game ad".diff --git a/skills/brag/references/audio.md b/skills/brag/references/audio.mdindex c7a504a..bf76d0f 100644--- a/skills/brag/references/audio.md+++ b/skills/brag/references/audio.md@@ -55,18 +55,18 @@ skills/brag/assets/sfx/sfx-analysis.json~/.claude/skills/brag/assets/sfx/sfx-analysis.json```-**Critical: copy audio files into the composition project before rendering.** Hyperframes validates and serves assets from the composition directory. Always copy the files you need into `brag-output/composition/assets/` first:+**Critical: copy audio files into the composition project before rendering.** Hyperframes validates and serves assets from the composition directory. Always copy the files you need into `<output-dir>/composition/assets/` first:```bash# Create local asset dirs-mkdir -p brag-output/composition/assets/sfx/interface brag-output/composition/assets/sfx/impact brag-output/composition/assets/sfx/casino brag-output/composition/assets/sfx/ui-mkdir -p brag-output/composition/assets/music+mkdir -p <output-dir>/composition/assets/sfx/interface <output-dir>/composition/assets/sfx/impact <output-dir>/composition/assets/sfx/casino <output-dir>/composition/assets/sfx/ui+mkdir -p <output-dir>/composition/assets/music# Copy only the files you plan to use (not the entire library)# From the repo copy:-cp skills/brag/assets/sfx/interface/bong_001.ogg brag-output/composition/assets/sfx/interface/-cp skills/brag/assets/sfx/impact/impactBell_heavy_000.ogg brag-output/composition/assets/sfx/impact/-cp skills/brag/assets/music/happy-beats-business-moves-vol-1-by-ende-dot-app.mp3 brag-output/composition/assets/music/+cp skills/brag/assets/sfx/interface/bong_001.ogg <output-dir>/composition/assets/sfx/interface/+cp skills/brag/assets/sfx/impact/impactBell_heavy_000.ogg <output-dir>/composition/assets/sfx/impact/+cp skills/brag/assets/music/happy-beats-business-moves-vol-1-by-ende-dot-app.mp3 <output-dir>/composition/assets/music/# From an installed Claude skill, use ~/.claude/skills/brag/assets/... instead.```diff --git a/skills/brag/references/step-2-plan.md b/skills/brag/references/step-2-plan.mdindex 8e5f9f0..0651283 100644--- a/skills/brag/references/step-2-plan.md+++ b/skills/brag/references/step-2-plan.md@@ -1,6 +1,6 @@# Step 2: Write the brag plan-Write `brag-output/brag-plan.md`. One focused page. This is the creative north star for the entire video.+Write `<output-dir>/brag-plan.md`. One focused page. This is the creative north star for the entire video.The plan should specify what the video must communicate and what project material must be used. It should not prescribe low-level Hyperframes implementation details. Hyperframes will decide the concrete composition structure, animation mechanics, and render workflow from the brief in Step 3.diff --git a/skills/brag/references/step-3-compose.md b/skills/brag/references/step-3-compose.mdindex ffda43b..983fee9 100644--- a/skills/brag/references/step-3-compose.md+++ b/skills/brag/references/step-3-compose.md@@ -2,7 +2,7 @@## Create the composition brief-Write `brag-output/composition-brief.md` before creating or editing the Hyperframes composition.+Write `<output-dir>/composition-brief.md` before creating or editing the Hyperframes composition.```markdown# Hyperframes Composition Brief: [App Name]@@ -11,8 +11,8 @@ Write `brag-output/composition-brief.md` before creating or editing the HyperfraCreate a short launch-style brag video for [App Name].## Output-- Composition directory: `brag-output/composition/`-- Rendered video: `brag-output/brag.mp4`+- Composition directory: `<output-dir>/composition/`+- Rendered video: `<output-dir>/brag.mp4`- Format: [landscape / vertical / square] — [width]x[height]- Duration: [15-25 seconds]@@ -47,7 +47,7 @@ Create a short launch-style brag video for [App Name].- Visual references from the project: [short list]## Storyboard-Use the storyboard in `brag-output/brag-plan.md` as the creative contract.+Use the storyboard in `<output-dir>/brag-plan.md` as the creative contract.Scene summary:1. [Scene name] — [duration]s — [what must be seen / read]@@ -67,7 +67,7 @@ Scene summary:- SFX selection guidance: [how sound should match motion and interaction; examples only, not rigid rules]- SFX analysis guidance: [path to sfx-analysis.md/json if present; use lower high-frequency-risk sounds for repeated or polished moments]- Exact SFX choice: Hyperframes should choose filenames, timestamps, density, and volume based on the implemented animation.-- Audio files: copy the chosen music and any Hyperframes-selected SFX into `brag-output/composition/assets/`+- Audio files: copy the chosen music and any Hyperframes-selected SFX into `<output-dir>/composition/assets/`## Hyperframes InstructionsLoad the composition-building Hyperframes domain skills — `hyperframes-core` (composition contract + `data-*` timing), `hyperframes-animation` (motion), `hyperframes-creative` (design spec, beats, audio-reactive), `hyperframes-keyframes` (seek-safe keyframes), and `hyperframes-cli` (lint/check/render). /brag is its own workflow: do not enter the `hyperframes` entry-point intent interview and do not route into its generic promo / launch-video workflow. Prefer native Hyperframes conventions over anything in `/brag`.@@ -182,13 +182,13 @@ If SFX are enabled, also pass `skills/brag/assets/sfx/sfx-analysis.md` as select## Call Hyperframes-After `brag-output/brag-plan.md`, `brag-output/composition-brief.md`, and selected audio assets exist:+After `<output-dir>/brag-plan.md`, `<output-dir>/composition-brief.md`, and selected audio assets exist:-1. Load the Hyperframes domain skills (`hyperframes-core`, `hyperframes-animation`, `hyperframes-creative`, `hyperframes-keyframes`, `hyperframes-cli`) to create or update `brag-output/composition/`. /brag is its own workflow — do not enter the `hyperframes` entry-point intent interview or route into its generic promo / launch-video workflow.+1. Load the Hyperframes domain skills (`hyperframes-core`, `hyperframes-animation`, `hyperframes-creative`, `hyperframes-keyframes`, `hyperframes-cli`) to create or update `<output-dir>/composition/`. /brag is its own workflow — do not enter the `hyperframes` entry-point intent interview or route into its generic promo / launch-video workflow.2. Pass Hyperframes the composition brief, the brag plan, and the source files it should reference.3. Let Hyperframes choose the implementation details.4. Run Hyperframes check (the single gate before render).-5. Render to `brag-output/brag.mp4`.+5. Render to `<output-dir>/brag.mp4`.Do not manually copy stale composition snippets from this skill into the output. The point of delegating is to benefit from the latest Hyperframes guidance.diff --git a/skills/brag/references/step-4-deliver.md b/skills/brag/references/step-4-deliver.mdindex cf6111b..bd83622 100644--- a/skills/brag/references/step-4-deliver.md+++ b/skills/brag/references/step-4-deliver.md@@ -3,7 +3,7 @@## Validate```bash-cd brag-output/composition+cd <output-dir>/compositionnpx hyperframes check # brag's single pre-render gate — fix every error it reports```@@ -31,7 +31,7 @@ If the user approves or asks to render:npx hyperframes render --output ../brag.mp4```-This outputs to `brag-output/brag.mp4` (one level up from the composition directory).+This outputs to `<output-dir>/brag.mp4` (one level up from the composition directory).For a faster iteration render:```bash@@ -47,7 +47,7 @@ npx hyperframes render --quality high --output ../brag.mp4The poster is the still shown before the video plays — the first thing anyone sees when it's idle or unplayed. Don't leave it to the raw first frame or an arbitrary timestamp; those land on fades, mid-transitions, blank intro backgrounds, or half-rendered text.-You built this composition, so you already know its strongest moment and exactly when it lands — the hook line, the hero reveal, or the final logo. Pick that beat at a **settled** point: text fully animated in, before it exits (the storyboard timings tell you the safe window). Then extract that one frame full-res with ffmpeg. From `brag-output/composition`:+You built this composition, so you already know its strongest moment and exactly when it lands — the hook line, the hero reveal, or the final logo. Pick that beat at a **settled** point: text fully animated in, before it exits (the storyboard timings tell you the safe window). Then extract that one frame full-res with ffmpeg. From `<output-dir>/composition`:```bash# use the timestamp of your strongest settled beat, e.g. 3.2s@@ -60,7 +60,7 @@ Aim for a frame that's postable on its own (the "show the thing" law — any froA bare `.mp4` has no `poster` attribute — every player and platform picks its own idle thumbnail, and almost all of them grab **frame 0**. Slack, Twitter/X, and Discord regenerate thumbnails server-side and ignore embedded cover-art metadata, so the *only* reliable way to control the idle image everywhere is to make frame 0 *be* the poster.-Replace **only** the first frame's pixels with `brag.jpg`, leaving every other frame and all timing untouched — same duration, same frame count, audio copied through. At 30fps the poster shows for 1/30s before the intro rolls, so it's imperceptible on playback but it's what every thumbnail grabber sees. From `brag-output`:+Replace **only** the first frame's pixels with `brag.jpg`, leaving every other frame and all timing untouched — same duration, same frame count, audio copied through. At 30fps the poster shows for 1/30s before the intro rolls, so it's imperceptible on playback but it's what every thumbnail grabber sees. From `<output-dir>`:```bashffmpeg -y -i brag.mp4 -i brag.jpg \@@ -74,7 +74,7 @@ The poster (`brag.jpg`) matches the video's dimensions because it was pulled fro## Write share copy-Write `brag-output/share-copy.txt`.+Write `<output-dir>/share-copy.txt`.The share copy should be:- One to three sentences max@@ -87,7 +87,7 @@ The share copy should be:If variants are useful, write them to a separate optional file:```text-brag-output/share-copy-variants.md+<output-dir>/share-copy-variants.md```### Share copy by tone@@ -145,10 +145,10 @@ Available in 12 metros.## Final output structure-After this step, `brag-output/` should contain:+After this step, `<output-dir>/` should contain:```-brag-output/+<output-dir>/brag.mp4 — the rendered videobrag.jpg — the poster (best frame, for <video poster>)brag-plan.md — the plan and storyboard@@ -162,7 +162,7 @@ brag-output/## Telling the userAfter everything is done, tell the user:-- Where the video is (`brag-output/brag.mp4`)+- Where the video is (`<output-dir>/brag.mp4`)- Where the share copy is- One sentence on what the video does creatively- Optionally: offer to re-roll a scene, change tone, or try a different angle