You built it. Now brag. Turn the project you just created into a short, shareable launch video with one command.
Add /brag-slim: a lean /brag for Claude Opus 5.5
shunithavivc893c5ed52ae
diff --git a/.agents/skills/brag-slim b/.agents/skills/brag-slimnew file mode 120000index 0000000..ab2a173--- /dev/null+++ b/.agents/skills/brag-slim@@ -0,0 +1 @@+../../skills/brag-slim\ No newline at end of filediff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex 5c1d7bc..59952fc 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "brag","description": "Turn the current project into a short, polished, shareable launch video using HyperFrames.",- "version": "0.3.0",+ "version": "0.4.0","author": {"name": "Shunit Haviv Hakimi","email": "[email protected]"diff --git a/.claude/skills/brag-slim b/.claude/skills/brag-slimnew file mode 120000index 0000000..ab2a173--- /dev/null+++ b/.claude/skills/brag-slim@@ -0,0 +1 @@+../../skills/brag-slim\ No newline at end of filediff --git a/.gitignore b/.gitignoreindex fb4cba5..469e116 100644--- a/.gitignore+++ b/.gitignore@@ -25,3 +25,5 @@ skills-lock.json# Codex packaging — excluded from the Claude-only initial release.codex-plugin/CODEX_PLUGIN_FOLLOWUPS.md++.codesk\ No newline at end of filediff --git a/.opencode/skills/brag-slim b/.opencode/skills/brag-slimnew file mode 120000index 0000000..ab2a173--- /dev/null+++ b/.opencode/skills/brag-slim@@ -0,0 +1 @@+../../skills/brag-slim\ No newline at end of filediff --git a/README.md b/README.mdindex 1f4355d..e6b2143 100644--- a/README.md+++ b/README.md@@ -8,14 +8,34 @@The looping video on the [launch site](https://latent-spaces.github.io/brag/) was made by `/brag` on this very repo.-## Install+## New: `/brag-slim`++**The same /brag, rebuilt lean for Opus 5.5.**++A smooth launch video, designed for your specific project, with its own soundtrack and share copy.++No Hyperframes, no bundled assets, same creative rules.++Just tell Opus 5.5: *let's /brag about this.*++On Opus 5.5, `/brag` switches to `/brag-slim` automatically. Run `/brag --full` to keep the classic Hyperframes workflow.++**Install just `/brag-slim`:**++```bash+npx skills add https://github.com/latent-spaces/brag --skill brag-slim+```++Already have the `/brag` plugin? `/brag-slim` is included from version 0.4.0. Run `claude plugin update brag` to get it.++## Install /brag```bash/plugin marketplace add latent-spaces/brag/plugin install brag@brag```-Then run `/brag` inside any project.+Then run `/brag` inside any project. The plugin includes `/brag-slim` too.**Any other agent** — one command via the [`skills`](https://github.com/vercel-labs/skills) CLI (Cursor, Codex, Copilot, Gemini CLI, opencode, and more):@@ -30,6 +50,7 @@ Add `-g` to install globally (available in every project); drop it to scope to t```bashrsync -a --exclude '.DS_Store' skills/brag/ ~/.claude/skills/brag/+rsync -a --exclude '.DS_Store' skills/brag-slim/ ~/.claude/skills/brag-slim/ # optional: the /brag-slim command```Restart Claude Code after copying.@@ -87,6 +108,7 @@ You get a `brag-output/` folder with the plan, a composition brief, share copy,## What's in this repo- `skills/brag/` — the skill, references, and bundled music + SFX+- `skills/brag-slim/` — `/brag-slim`, the single-file skill for Claude Opus 5.5- `examples/` — fake product sites used as a benchmark suite- `docs/` — the launch site (GitHub Pages)- `.claude-plugin/` — plugin manifest + marketplace catalogdiff --git a/docs/assets/brag-slim/brag.jpg b/docs/assets/brag-slim/brag.jpgnew file mode 100644index 0000000..6a5c04bBinary files /dev/null and b/docs/assets/brag-slim/brag.jpg differdiff --git a/docs/assets/brag-slim/brag.mp4 b/docs/assets/brag-slim/brag.mp4new file mode 100644index 0000000..2f729c3Binary files /dev/null and b/docs/assets/brag-slim/brag.mp4 differdiff --git a/docs/index.html b/docs/index.htmlindex 44ca32d..dcf1df4 100644--- a/docs/index.html+++ b/docs/index.html@@ -15,11 +15,12 @@<link rel="stylesheet" href="styles.css" /></head><body>-<a class="skip-link" href="#examples">skip to examples</a>+<a class="skip-link" href="#main">skip to content</a><header class="hero"><div class="topbar"><span class="mark">/brag</span>+ <a class="slim-pill" href="#slim"><span class="slim-pill-tag">new</span><span class="slim-pill-text">/brag-slim<span class="slim-pill-sep" aria-hidden="true"> · </span><span class="slim-pill-tagline">the same /brag, rebuilt lean</span></span><svg class="slim-pill-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.25" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 5v14M5 12l7 7 7-7"/></svg></a><nav aria-label="primary"><a href="#examples">examples</a><a href="#install">install</a>@@ -66,14 +67,42 @@</div><div class="hero-foot" id="install">- <div class="install-stack"><span class="install-label">claude code</span><pre class="install" aria-label="Claude Code install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="/plugin marketplace add latent-spaces/brag /plugin install brag@brag">copy</button></span><code><span class="prompt">$</span> /plugin marketplace add latent-spaces/brag+ <div class="install-stack"><span class="install-label">claude code · includes /brag-slim</span><pre class="install" aria-label="Claude Code install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="/plugin marketplace add latent-spaces/brag /plugin install brag@brag">copy</button></span><code><span class="prompt">$</span> /plugin marketplace add latent-spaces/brag<span class="prompt">$</span> /plugin install brag@brag</code></pre><span class="install-label">any other agent</span><pre class="install" aria-label="any-agent install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="npx skills add https://github.com/latent-spaces/brag --skill brag">copy</button></span><code><span class="prompt">$</span> npx skills add https://github.com/latent-spaces/brag --skill brag</code></pre></div><div class="hero-meta"><span class="dot" aria-hidden="true"></span>plays well with all agents · made by <a href="https://github.com/shunithaviv" style="color:inherit;">@shunithaviv</a></div></div></header>-<main id="examples">- <section class="gallery" aria-labelledby="gallery-title">+<main id="main">+ <section class="slim" id="slim" aria-labelledby="slim-title">+ <div class="slim-inner">+ <div class="slim-copy">+ <h2 class="slim-title" id="slim-title">+ <span class="slim-name"><span class="slim-cmd">/brag-slim</span><span class="slim-new">new</span></span>+ <span class="slim-tagline">the same /brag,<br/><em>rebuilt lean</em><br/>for opus 5.5.</span>+ </h2>++ <p class="slim-ask">+ <span class="slim-ask-lead">Just tell Opus 5.5:</span>+ <span class="slim-prompt"><span class="prompt" aria-hidden="true">></span> let's /brag about this.<span class="slim-caret" aria-hidden="true"></span></span>+ </p>++ <p class="slim-lede">No Hyperframes, no bundled assets, same creative rules.</p>++ <p class="slim-switch">On Opus 5.5, <code>/brag</code> switches to <code>/brag-slim</code> automatically. Want the classic Hyperframes workflow? Run <code>/brag --full</code>.</p>++ <div class="install-stack slim-install"><span class="install-label">install with one command</span><pre class="install" aria-label="/brag-slim install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="npx skills add https://github.com/latent-spaces/brag --skill brag-slim">copy</button></span><code><span class="prompt">$</span> npx skills add https://github.com/latent-spaces/brag --skill brag-slim</code></pre><p class="slim-update">Already on the /brag plugin? It's included from v0.4.0. Run <code>claude plugin update brag</code>.</p></div>+ </div>++ <figure class="slim-media has-video" style="--slim-ratio: 1 / 1">+ <div class="slim-screen">+ <video class="slim-video" src="assets/brag-slim/brag.mp4" poster="assets/brag-slim/brag.jpg" controls playsinline preload="metadata" aria-label="the /brag-slim brag video"></video>+ </div>+ </figure>+ </div>+ </section>++ <section class="gallery" id="examples" aria-labelledby="gallery-title"><div class="gallery-head"><div><p class="gallery-eyebrow">three real projects · three real brags</p>@@ -158,7 +187,7 @@<p class="outro-meta">we used <code>/brag</code> to brag about <code>/brag</code>. the twenty-second video looping in the top-right corner of this page was made by the skill itself, on this very project. that's the demo.</p><div class="outro-actions"><div class="install-stack"><span class="install-label">claude code</span><pre class="install" aria-label="Claude Code install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="/plugin marketplace add latent-spaces/brag /plugin install brag@brag">copy</button></span><code><span class="prompt">$</span> /plugin marketplace add latent-spaces/brag-<span class="prompt">$</span> /plugin install brag@brag</code></pre><span class="install-label">any other agent</span><pre class="install" aria-label="any-agent install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="npx skills add https://github.com/latent-spaces/brag --skill brag">copy</button></span><code><span class="prompt">$</span> npx skills add https://github.com/latent-spaces/brag --skill brag</code></pre></div>+<span class="prompt">$</span> /plugin install brag@brag</code></pre><span class="install-label">any other agent</span><pre class="install" aria-label="any-agent install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="npx skills add https://github.com/latent-spaces/brag --skill brag">copy</button></span><code><span class="prompt">$</span> npx skills add https://github.com/latent-spaces/brag --skill brag</code></pre><span class="install-label">just /brag-slim</span><pre class="install" aria-label="/brag-slim install command"><span class="copy-wrap"><button class="copy" type="button" data-copy="npx skills add https://github.com/latent-spaces/brag --skill brag-slim">copy</button></span><code><span class="prompt">$</span> npx skills add https://github.com/latent-spaces/brag --skill brag-slim</code></pre></div></div></div><div class="colophon">diff --git a/docs/styles.css b/docs/styles.cssindex c29ca4a..3b1e3a0 100644--- a/docs/styles.css+++ b/docs/styles.css@@ -711,6 +711,225 @@ button { font: inherit; cursor: pointer; }.outro-actions { justify-items: start; }}+/* === /brag-slim announcement === */++/* Topbar pill: first-viewport pointer to the #slim section */+.slim-pill {+ display: inline-flex;+ align-items: center;+ gap: 10px;+ padding: 6px 12px 6px 6px;+ border-radius: 999px;+ background: var(--hero-ink);+ color: var(--hero-tint);+ text-decoration: none;+ font-family: "Geist Mono", ui-monospace, monospace;+ font-size: 13px;+ line-height: 1.2;+ letter-spacing: -0.005em;+ align-self: center;+ box-shadow: 0 8px 24px -12px oklch(20% 0.08 var(--hue) / 0.6);+ transition: transform 220ms var(--ease-out), box-shadow 220ms var(--ease-out);+}+.slim-pill-tag {+ background: var(--hero-bg);+ color: var(--hero-ink);+ border-radius: 999px;+ padding: 3px 8px;+ font-size: 11px;+ font-weight: 700;+ letter-spacing: 0.08em;+ text-transform: uppercase;+}+.slim-pill-text { font-weight: 700; white-space: nowrap; }+.slim-pill-sep { opacity: 0.5; font-weight: 400; }+.slim-pill-tagline { font-weight: 400; color: oklch(84% 0.04 var(--hue)); }+.slim-pill-arrow { width: 14px; height: 14px; flex: 0 0 14px; color: oklch(72% 0.18 var(--hue)); transition: transform 220ms var(--ease-out); }+.slim-pill:hover,+.slim-pill:focus-visible {+ transform: translateY(-1px);+ box-shadow: 0 14px 30px -14px oklch(20% 0.08 var(--hue) / 0.75);+}+.slim-pill:hover .slim-pill-arrow,+.slim-pill:focus-visible .slim-pill-arrow { transform: translateY(2px); }+.slim-pill:focus-visible { outline: 2px solid var(--hero-ink); outline-offset: 3px; }++/* Section: a paper band between the orange hero and the dark gallery */+.slim {+ background: var(--hero-tint);+ color: var(--hero-ink);+ padding: clamp(72px, 10vw, 150px) clamp(20px, 3vw, 40px);+ scroll-margin-top: 0;+}+.slim ::selection,+.slim::selection { background: var(--hero-bg); color: var(--hero-ink); }+.slim-inner {+ max-width: var(--max-page);+ margin: 0 auto;+ display: grid;+ grid-template-columns: minmax(0, 1.4fr) minmax(0, 1fr);+ gap: clamp(48px, 7vw, 120px);+ align-items: center;+}+.slim-copy { min-width: 0; container-type: inline-size; }++.slim-title { margin: 0; font-weight: 900; }+.slim-name {+ display: flex;+ align-items: center;+ gap: 14px;+ font-family: "Geist Mono", ui-monospace, monospace;+ font-size: clamp(24px, 2.6vw, 38px);+ font-weight: 700;+ letter-spacing: -0.03em;+ line-height: 1;+ margin-bottom: clamp(18px, 2vw, 28px);+}+.slim-new {+ display: inline-block;+ background: var(--hero-bg);+ color: var(--hero-ink);+ font-size: 12px;+ font-weight: 700;+ letter-spacing: 0.1em;+ text-transform: uppercase;+ padding: 6px 10px 5px;+ border-radius: var(--radius-sm);+ transform: rotate(-6deg);+}+.slim-tagline {+ display: block;+ font-family: "Geist", system-ui, sans-serif;+ font-size: clamp(40px, 6.4vw, 108px);+ font-size: clamp(32px, 10.4cqi, 100px); /* sized so the knockout line holds one line */+ line-height: 0.88;+ letter-spacing: -0.04em;+ text-transform: lowercase;+ text-wrap: balance;+}+.slim-tagline em {+ font-style: italic;+ background: var(--hero-ink);+ color: var(--hero-bg);+ display: inline-block;+ margin-top: 0.14em; /* clear the descenders of "brag," above */+ padding: 0.02em 0.08em 0.06em 0.04em;+ line-height: 0.9;+ white-space: nowrap;+}++.slim-ask {+ margin: clamp(36px, 4vw, 56px) 0 0;+ display: grid;+ justify-items: start;+ gap: 12px;+}+.slim-ask-lead {+ font-size: clamp(18px, 1.6vw, 22px);+ font-weight: 500;+ letter-spacing: -0.01em;+ color: var(--hero-ink-soft);+}+.slim-prompt {+ display: inline-flex;+ align-items: center;+ gap: 0.55em;+ max-width: 100%;+ font-family: "Geist Mono", ui-monospace, monospace;+ font-size: clamp(18px, 2vw, 28px);+ font-weight: 500;+ letter-spacing: -0.02em;+ line-height: 1.2;+ background: var(--hero-ink);+ color: var(--hero-tint);+ padding: 0.62em 0.9em;+ border-radius: var(--radius-md);+ transform: rotate(-1deg);+ box-shadow: 0 18px 40px -22px oklch(20% 0.08 var(--hue) / 0.7);+}+.slim-prompt .prompt { color: oklch(72% 0.18 var(--hue)); }+.slim-caret {+ display: inline-block;+ width: 0.55em;+ height: 1.05em;+ margin-left: -0.3em;+ background: var(--hero-bg);+ animation: slim-blink 1.1s steps(1, end) infinite;+}+@keyframes slim-blink { 50% { opacity: 0; } }++.slim-lede {+ margin: clamp(32px, 3.4vw, 44px) 0 0;+ max-width: 46ch;+ font-size: clamp(18px, 1.5vw, 21px);+ line-height: 1.4;+ font-weight: 500;+ letter-spacing: -0.012em;+ color: var(--hero-ink-soft);+}+.slim-lede strong { color: var(--hero-ink); font-weight: 600; }+.slim-switch,+.slim-update {+ margin: 16px 0 0;+ max-width: 52ch;+ font-size: 15px;+ line-height: 1.5;+ color: var(--hero-ink-soft);+}+.slim-switch code,+.slim-update code {+ font-family: "Geist Mono", ui-monospace, monospace;+ font-size: 0.92em;+ color: var(--hero-ink);+ background: oklch(90% 0.04 var(--hue));+ padding: 1px 6px;+ border-radius: 4px;+ white-space: nowrap;+}+.slim-install { margin-top: clamp(32px, 3.4vw, 44px); }+.slim-install .install { padding-right: 76px; } /* keep "brag-slim" clear of the copy button */+.slim-install .install code { white-space: pre-wrap; overflow-wrap: anywhere; } /* wrap, never hide the skill name */+.slim-install .slim-update { margin-top: 4px; font-size: 14px; }++/* Media: the /brag-slim video */+.slim-media {+ margin: 0;+ min-width: 0;+ display: grid;+ gap: 16px;+ justify-items: center;+}+.slim-screen {+ width: 100%;+ max-width: 460px;+ border-radius: var(--radius-md);+ background: var(--hero-ink);+ color: var(--hero-tint);+ overflow: hidden;+ transform: rotate(-2deg);+ box-shadow: 0 30px 80px -24px oklch(20% 0.08 var(--hue) / 0.5);+}+.slim-media.has-video .slim-screen { max-width: 560px; aspect-ratio: var(--slim-ratio, 16 / 9); }+.slim-video {+ display: block;+ width: 100%;+ height: 100%;+ object-fit: cover;+ background: var(--hero-ink);+}++@media (max-width: 900px) {+ .slim-inner { grid-template-columns: minmax(0, 1fr); }+ .slim-screen { transform: rotate(-1.5deg); }+}+@media (max-width: 720px) {+ .slim-pill { align-self: flex-start; }+}+@media (max-width: 480px) {+ .slim-pill-sep, .slim-pill-tagline { display: none; }+ .slim-prompt { transform: none; }+}+/* === Reduced motion === */@media (prefers-reduced-motion: reduce) {*, *::before, *::after {diff --git a/scripts/check-brag-slim.mjs b/scripts/check-brag-slim.mjsnew file mode 100644index 0000000..4729272--- /dev/null+++ b/scripts/check-brag-slim.mjs@@ -0,0 +1,21 @@+#!/usr/bin/env node++// /brag bundles a copy of /brag-slim (skills/brag/slim.md) so its Opus 5.5 hand-off+// works no matter how /brag was installed. The two files must stay identical.++import { readFile } from "node:fs/promises";+import path from "node:path";+import { fileURLToPath } from "node:url";++const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");+const source = "skills/brag-slim/SKILL.md";+const copy = "skills/brag/slim.md";++const [a, b] = await Promise.all([source, copy].map((p) => readFile(path.join(root, p), "utf8")));++if (a !== b) {+ console.error(`${copy} is out of sync with ${source}. Fix it with:\n cp ${source} ${copy}`);+ process.exit(1);+}++console.log(`${copy} matches ${source}.`);diff --git a/skills/brag-slim/SKILL.md b/skills/brag-slim/SKILL.mdnew file mode 100644index 0000000..15d294a--- /dev/null+++ b/skills/brag-slim/SKILL.md@@ -0,0 +1,101 @@+---+name: brag-slim+description: Turn a project directory or a website URL into a short, shareable launch video with music, motion, and share copy. One file, no bundled assets — built entirely by the model with the tools already on the machine. Use when someone says "/brag-slim", "let's /brag about this", "brag about <url>", "make a launch video", or wants to show off what they built. If the /brag skill is also installed, let /brag handle those phrases; it hands off here on Opus 5.5.+---++# /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):++| Option | Default |+|---|---|+| `--tone <preset or freeform>` | inferred; `default` if nothing clearly fits |+| `--format landscape\|vertical\|square` | landscape (1920×1080; vertical 1080×1920, square 1080×1080), 30fps |+| `--duration <s>` | about 20s |++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.++| Input | How to recognize it | Where the material comes from |+|---|---|---|+| Project | No input given, and the current directory is a project | The code |+| Website | An `http(s)://` URL, or a bare domain like `example.com` | The live site |++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.++## Tones++Presets are defaults; freeform direction ("fake Series A launch from 2016") refines or overrides them.++| Tone | Feel | Pacing / transitions |+|---|---|---|+| `default` | Punchy, playful, clean | 4–5 scenes; soft transitions |+| `polished` | Serious, elegant, restrained | 3–4 scenes, long holds; soft fades |+| `yc-parody` | Deadpan startup launch, played straight | 4–5 scenes, one claim each; hard cuts |+| `chaotic` | FAST, LOUD, ALL CAPS | 6–8 scenes, some under 2s; flash/zoom cuts |+| `deadpan` | Calm, dry, nothing is a joke | 3–4 scenes, big empty space; slow fades |+| `cinematic` | Trailer-scale, epic claims | 4–5 scenes, big type; dramatic wipes |+| `app-store` | Clean feature cards | 4–6 scenes; smooth slides |++## Sound++Write the music and sound effects as one piece: effects in the same key and the same space as the music, blended in rather than laid on top. Give it a basic, proper mix, the way a real track is mixed: effects sit softly under the music, nothing harsh or spiky, and repeated little sounds stay in the background.++## 3. Build, check, render++Build it with whatever works on this machine. If you draw the video in a browser, make every frame a pure function of time and wait for fonts and images to load before capturing each one.++Before the full render, look at stills from every scene *and* from mid-transition, and fix overflow, collisions, and low contrast. A plain crossfade between two busy layouts makes a muddy double exposure; stagger it (old content out, then new content in) or dip through the background. Then render `brag.mp4`.++## 4. Deliver++- **Poster:** pull the strongest *settled* frame (text fully in, not mid-transition) to `brag.jpg`, and bake it in as frame 0 of `brag.mp4` so every platform's thumbnail shows it. Replace frame 0 rather than adding a frame, so the duration and audio sync stay the same.+- **`share-copy.txt`:** 1–3 sentences, postable as-is, specific, matching the tone. No "excited to share."+- **Tell the user** where the video and copy are, give one sentence on the creative angle, and offer to re-roll a scene or try another tone.diff --git a/skills/brag/SKILL.md b/skills/brag/SKILL.mdindex a2869ec..7e929a8 100644--- a/skills/brag/SKILL.md+++ b/skills/brag/SKILL.md@@ -9,6 +9,8 @@ You built it. Now let's brag about it.## Invocation dispatch (must happen first)+**Model check.** If you are Claude Opus 5.5 and the invocation doesn't ask for the full workflow (`--full`, "use the full brag") or for voiceover (`--voice`, which brag-slim doesn't do), switch to brag-slim: read `<skill-dir>/slim.md` (the /brag-slim skill, bundled here) and follow it for the rest of this run instead of this file. Pass along the user's input, and pass any other options (`--no-music`, `--title`, …) as plain-language direction. Tell the user in one line first, e.g. "You're on Opus 5.5, so I'm using /brag-slim: I build the whole video myself. Say 'use the full brag' to switch back." If you are any other model, or can't tell which model you are, skip this check.+Before inspecting the project, parse the complete `/brag` invocation. If theinvocation contains `--voice`, set `voice.enabled = true`. Enable narrationonly for that run. Do not enable narration automatically and do not fall backdiff --git a/skills/brag/slim.md b/skills/brag/slim.mdnew file mode 100644index 0000000..15d294a--- /dev/null+++ b/skills/brag/slim.md@@ -0,0 +1,101 @@+---+name: brag-slim+description: Turn a project directory or a website URL into a short, shareable launch video with music, motion, and share copy. One file, no bundled assets — built entirely by the model with the tools already on the machine. Use when someone says "/brag-slim", "let's /brag about this", "brag about <url>", "make a launch video", or wants to show off what they built. If the /brag skill is also installed, let /brag handle those phrases; it hands off here on Opus 5.5.+---++# /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):++| Option | Default |+|---|---|+| `--tone <preset or freeform>` | inferred; `default` if nothing clearly fits |+| `--format landscape\|vertical\|square` | landscape (1920×1080; vertical 1080×1920, square 1080×1080), 30fps |+| `--duration <s>` | about 20s |++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.++| Input | How to recognize it | Where the material comes from |+|---|---|---|+| Project | No input given, and the current directory is a project | The code |+| Website | An `http(s)://` URL, or a bare domain like `example.com` | The live site |++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.++## Tones++Presets are defaults; freeform direction ("fake Series A launch from 2016") refines or overrides them.++| Tone | Feel | Pacing / transitions |+|---|---|---|+| `default` | Punchy, playful, clean | 4–5 scenes; soft transitions |+| `polished` | Serious, elegant, restrained | 3–4 scenes, long holds; soft fades |+| `yc-parody` | Deadpan startup launch, played straight | 4–5 scenes, one claim each; hard cuts |+| `chaotic` | FAST, LOUD, ALL CAPS | 6–8 scenes, some under 2s; flash/zoom cuts |+| `deadpan` | Calm, dry, nothing is a joke | 3–4 scenes, big empty space; slow fades |+| `cinematic` | Trailer-scale, epic claims | 4–5 scenes, big type; dramatic wipes |+| `app-store` | Clean feature cards | 4–6 scenes; smooth slides |++## Sound++Write the music and sound effects as one piece: effects in the same key and the same space as the music, blended in rather than laid on top. Give it a basic, proper mix, the way a real track is mixed: effects sit softly under the music, nothing harsh or spiky, and repeated little sounds stay in the background.++## 3. Build, check, render++Build it with whatever works on this machine. If you draw the video in a browser, make every frame a pure function of time and wait for fonts and images to load before capturing each one.++Before the full render, look at stills from every scene *and* from mid-transition, and fix overflow, collisions, and low contrast. A plain crossfade between two busy layouts makes a muddy double exposure; stagger it (old content out, then new content in) or dip through the background. Then render `brag.mp4`.++## 4. Deliver++- **Poster:** pull the strongest *settled* frame (text fully in, not mid-transition) to `brag.jpg`, and bake it in as frame 0 of `brag.mp4` so every platform's thumbnail shows it. Replace frame 0 rather than adding a frame, so the duration and audio sync stay the same.+- **`share-copy.txt`:** 1–3 sentences, postable as-is, specific, matching the tone. No "excited to share."+- **Tell the user** where the video and copy are, give one sentence on the creative angle, and offer to re-roll a scene or try another tone.