Brag Slim

/brag-slim

You built it. Now brag. You make the whole video yourself — story, visuals, audio, render — with whatever tools are on the machine.

Whatever the tone, it should feel like a modern, slick, polished launch video: nothing on screen or in the soundtrack that doesn't earn its place.

Usage: /brag-slim [input] [options]. Options (flags or plain language):

Write the deliverables to brag-output/ in the current directory (timestamped brag-output-YYYY-MM-DD-HHmmss/ if it already exists). Keep every intermediate file (frames, downloads, scripts, stems) in a work/ subfolder inside it.

1. Inspect

First decide what the input is, then gather material from it. Only the source changes; everything from the questions below onward is the same for every input.

If the input matches no type, or there's no input and the current directory isn't a project, ask the user what to brag about.

Project

Read the code: the main page, styles (exact colors and fonts), README, routes and key components. The best material is the product in use — find its 2–3 beats: entry → key action → result.

You have the source, so use it directly: import or render the project's real components, stylesheets, fonts, images and animations in the video instead of rebuilding them.

Website

Get the site as a visitor sees it. Many sites build their page with JavaScript, so a plain download can come back as an almost empty shell. If it does, load the page in a headless browser to get the rendered result. Dismiss cookie banners and other overlays, and scroll section by section, since content that animates in on scroll stays blank in a single full-page capture.

• Copy: headline, tagline, section headings, feature names, calls to action, testimonials. Also check the title, meta description and social-preview tags.
• Identity: exact colors from the site's CSS and the fonts it loads.
• Visuals: the logo, product screenshots, hero images, demo videos. Download the ones you'll use into work/.
• Screenshots: capture the page at the video's aspect ratio to understand the layout. In the video, reuse the site's real markup, CSS and assets and animate those, rather than panning over flat screenshots.
• The product in use: check the demo videos, how-it-works sections and linked docs for the entry → key action → result flow.

Then, for every input

Before planning, answer: What is it (one sentence)? Who is it for, and what does it do for them? What sets it apart? What's the most impressive or funniest claim? What's the visual hook? What real UI or flow should be shown? What tone fits? What's the one-line share caption?

2. Plan

Write brag-plan.md: the angle, the hook, 2–3 highlights, the punchline, tone, visual identity, and a scene-by-scene storyboard with durations that sum to the target.

If the user points at one part — a new version, a new feature, one angle — make this the focus of the video.

Shape: Hook (2–3s) → Reveal (2–4s) → 2–3 sharp highlights → Punchline/outro (2–4s). A starting shape, not a template.

Creative laws

• Short. 15–25 seconds; 18–22 is the sweet spot.
• Clear to a stranger. After one viewing, someone who's never heard of it knows what it does, who it's for, and how to get it. Lead with that, not with how it's built.
• The hook is everything. The first 2 seconds decide whether anyone keeps watching. Plan it first.
• Show the thing. Reuse the real thing from the source — its UI, components, copy, images, videos and animations — rather than re-creating it. Rebuild only what you can't reuse. Prefer the working app doing its job over a landing page describing it. Small illustrative UI text is fine when showing the product in use (a filename, an "Exported" toast); invented claims, numbers, or testimonials are not. Never abstract filler.
• Specific. It must feel made for this exact project. Use its own copy and claims; no generic SaaS language ("streamline your workflow" is banned).
• Readable. Pace comes from motion and cuts, not from pulling text away early. Any line the viewer is meant to read stays fully visible and settled long enough to read it (roughly 0.3s per word), counted from when the whole line is on screen. Text that's only texture doesn't need to be read.
• Make it alive. Things that appear one by one, simulated clicks, swipes, and typing beat static slides.
• Funny earns its place. Humor comes from the project's own absurdity, not from trying.
• Every frame postable. Any frozen frame should be worth sharing.