PlugWiki

/brag (latent-spaces/brag): a skill that makes a short launch video from your project

/brag makes Claude read your project's code and build a 15 to 25 second launch video with music, sound effects and a share caption.

Installs
22K
on skills.sh
Stars
19.9K
on GitHub
Files
60+
besides SKILL.md
Updated
Oct 2026
last repo commit

You say "let's /brag" in a project folder. Claude reads the code, plans a short concept for that specific project, writes a storyboard, hands a brief to Hyperframes to build the composition, checks it, renders brag.mp4 and writes a share caption. Output goes to a brag-output/ folder: the plan, the composition, the video, a poster frame and share-copy.txt.

You steer it with options: --tone (default, polished, yc-parody, chaotic, deadpan, cinematic, app-store, or your own wording), --format (landscape, vertical, square), --duration, --no-music, --no-sfx, --title and --voice for narration. Narration is off unless you pass --voice, and it then uses Kokoro through Hyperframes. On Claude Opus 5.5 the skill switches to its lighter bundled /brag-slim workflow unless you ask for --full.

The README requires Node.js 22+, FFmpeg on your PATH and the Hyperframes CLI (npx hyperframes). SKILL.md also tells Claude to load four Hyperframes skills, which this skill does not bundle. See the FAQ and the permissions section.

Good for

  • Indie makers who want a shareable launch clip without video editing
  • Developers who built something and want a video for X, Product Hunt or a README
  • Teams who want a tone-driven video, such as polished, deadpan or chaotic

Install brag

Claude Code

  1. 1

    Copy this prompt.

    Install the brag skill in Claude Code. Run this command:
    
    npx skills add https://github.com/latent-spaces/brag --skill brag -a claude-code
    npx skills add heygen-com/hyperframes --skill hyperframes --skill hyperframes-cli --skill hyperframes-registry --skill media-use -a claude-code
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 22+, FFmpeg.

/brag tells Claude to load four Hyperframes skills (hyperframes, hyperframes-cli, hyperframes-registry, media-use), so the second command installs them from the heygen-com/hyperframes repo (the Hyperframes README lists them as its core set and none is marked internal). You also need Node.js 22+ and FFmpeg on PATH; check with npx hyperframes doctor. The Hyperframes README says npx hyperframes skills update installs the same core set from the current main branch. The brag README also documents a Claude Code plugin (/plugin marketplace add latent-spaces/brag, then /plugin install brag@brag); it does not install the Hyperframes skills, so run the second command after it.

From the project README. Source.

What's in the skill

When it loads

Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone says "/brag", "let's brag about this", "make a launch video", "turn this into a video", or wants to share what they built. Reads the project code directly — no live URL or screenshots needed.

Sections in SKILL.md

  1. Invocation dispatch (must happen first)
  2. What this skill does
  3. Parsing the invocation
  4. Narration guidance
  5. Output directory
  6. Skill directory
  7. Step 1: Inspect the project
  8. Step 2: Plan and storyboard
  9. Step 3: Hand off to Hyperframes
  10. Step 4: Validate, render, and deliver
  11. Tone system
  12. Creative laws

Key facts

License
MIT
Installs on skills.sh
22,008 as of 2026-11-02
Last repo commit
2026-10-23

What it includes

  • Picks the Opus 5.5 slim path or the full workflow, and reads --voice

    On Claude Opus 5.5 it follows the bundled slim.md instead, unless you ask for --full or --voice. Narration is enabled only when --voice is in the command.

    Invocation dispatch

  • Reads your code to answer a 9-question planning rubric

    Follows references/step-1-inspect.md. The reference says nothing read here should leak secrets, tokens or personal data into a public video.

    Read · Step 1: Inspect the project

  • Writes brag-plan.md with scenes, text, timing and SFX cues

    Commits to a creative angle. Scene durations must sum to 15 to 25 seconds.

    Files · Step 2: Plan and storyboard

  • Writes a composition brief and builds the video composition

    Loads the Hyperframes skills, writes the composition into <output-dir>/composition/ and gates on npx hyperframes check passing.

    Runs code · Step 3: Hand off to Hyperframes

  • Renders brag.mp4, picks a poster frame, writes share-copy.txt

    Runs npx hyperframes check, snapshot, preview and render, uses ffmpeg to extract a poster frame and bake it in as frame 0.

    Runs code · Step 4: Validate, render, deliver

  • Seven tones plus freeform direction

    default, polished, yc-parody, chaotic, deadpan, cinematic and app-store.

    Tone presets

  • 5 music tracks and 262 sound effect files

    Tracks come with cue files for beat sync. Cue metadata is optional timing guidance.

    Read · Bundled music and sound effects

  • Optional script that analyses any audio track for beat cues

    Run through uv with the librosa, numpy, scipy and soundfile packages from pyproject.toml. It writes cue JSON and Markdown files.

    Runs code · analyze_music_cues.py

  • A lighter single-file workflow

    Takes a project folder or a website URL. For a URL it downloads media assets to a work folder and may load the page in a headless browser.

    Runs code · slim.md (/brag-slim)

From the official docs

Permissions

Medium risk

Claude runs video tools on your machine and puts parts of your project into a video you may post. Review the finished video for secrets and approve commands you do not recognise.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Your project can end up in a public video

    Claude reads your code and shows real UI and copy on screen. The skill says not to carry secrets, tokens, internal URLs or personal data into the video, but check the final render before you post it.

  • Runs npx, ffmpeg and a Python script

    The workflow runs npx hyperframes check, snapshot, preview, render and tts, ffmpeg for the poster frame, and optionally uv run on analyze_music_cues.py, which uses librosa, numpy, scipy and soundfile from pyproject.toml. Approve commands you do not recognise.

  • Companion skill media-use can sign in to HeyGen and spend credits

    /brag loads the Hyperframes media-use skill for audio. Its SKILL.md describes a HeyGen sign-in (`npx hyperframes auth login`), a catalog and generation that use HyperFrames credits, and a `heygen` CLI for some recipes. /brag itself bundles music and sound effects. Watch for sign-in or credit prompts during a run.

  • Writes a new output folder

    Output goes to brag-output/ or a timestamped folder in your project. Add it to .gitignore if you do not want to commit the video.

  • Slim mode downloads site assets

    slim.md can load a URL in a headless browser and download media into a work folder. It says never to run anything it downloads.

  • Installs four skills from another repo

    The install box adds hyperframes, hyperframes-cli, hyperframes-registry and media-use from heygen-com/hyperframes. Each is a separate skill with its own commands (npx hyperframes ...).

Technical details
Talks toHyperframes CLI through npx. Hyperframes text-to-speech (Kokoro), only with --voice. Website downloads in the /brag-slim URL mode. HeyGen (media-use sign-in, catalog and generation), if media-use is asked for them
Sign-in and keys/brag asks for no login. The media-use skill describes a HeyGen sign-in handled by `npx hyperframes auth login`; the README of /brag does not say where that session is stored.

Questions

What does /brag do?

It makes Claude turn the project in your current folder into a 15 to 25 second launch video. Claude reads the code, plans and storyboards a short concept, builds the video with Hyperframes, renders brag.mp4 and writes a share caption.

How do I install it in Claude Code, the Claude app or Codex?

Use the install box above. It installs /brag and the four Hyperframes skills it loads, using the skills CLI, and works for Claude Code, Codex and any agent the skills CLI supports. The brag README also documents a Claude Code plugin (/plugin marketplace add latent-spaces/brag, then /plugin install brag@brag) and a Codex plugin. The plugin includes /brag-slim too, and its manifest lists no hooks or MCP servers. Neither plugin installs the Hyperframes skills. The README does not describe a Claude app upload, and the video steps need Node.js, FFmpeg and npx on your machine.

What do I need besides the skill?

Node.js 22+, FFmpeg on your PATH and the Hyperframes CLI, checked with npx hyperframes doctor. SKILL.md also tells Claude to load four Hyperframes skills: hyperframes, hyperframes-cli, hyperframes-registry and media-use. They live in the heygen-com/hyperframes repo, not in this skill's folder. The install box installs them with npx skills add heygen-com/hyperframes --skill ...; the Hyperframes README calls these four its core set.

Does it need an API key?

/brag's own SKILL.md names no credentials, and narration with --voice uses Kokoro through Hyperframes. The media-use skill that /brag loads for audio says that HeyGen's music catalog, voices and asset search need a free HeyGen sign-in (npx hyperframes auth login), and that generated media spends HyperFrames credits. Whether a /brag run reaches those paths depends on what Claude asks media-use for; /brag bundles its own music and sound effects.

Is it safe to install?

The skill runs shell commands such as npx hyperframes and ffmpeg, writes files into your project and may run a Python script with uv. The video can end up public, so check that no secrets, internal URLs or customer names appear on screen. The inspect reference and slim.md tell Claude not to carry secrets into the video.

What is /brag-slim and when does it run?

It is a lighter workflow written in one file, bundled here as slim.md. On Claude Opus 5.5, /brag switches to it by default. Say 'use the full brag' or pass --full to keep the Hyperframes workflow, or pass --voice, which slim does not do.

Can I get the video without running it myself?

The README points to letsbrag.app, which runs /brag for a site link you paste. This page covers only the skill you run yourself.

Information

updated Nov 2, 2026

Folder
skills/brag

latent-spaces/bragskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8
  1. brag README · github.com
  2. Hyperframes README · github.com
  3. SKILL.md · github.com
  4. step-4-deliver.md · github.com
  5. audio.md · github.com
  6. slim.md · github.com
  7. pyproject.toml · github.com
  8. media-use SKILL.md (Hyperframes) · github.com

Updated Nov 2, 2026.