From a7c080ca66d32b1ec2cb71e15896c5b0dc2470e8 Mon Sep 17 00:00:00 2001 From: Brooklyn Nicholson Date: Sat, 26 Sep 2026 16:52:05 -0500 Subject: [PATCH] feat(skills): brag and brag-slim join the optional-skills catalog as upstream stubs latent-spaces/brag (MIT) turns the project you just built into a short launch video with music, motion and share copy. It ships two skills: /brag, the Hyperframes workflow with a bundled music and SFX library, and /brag-slim, a single SKILL.md where the model builds the whole video with local tools. /brag hands off to its bundled copy of brag-slim on Claude Opus 5.5. Both follow the impeccable/archify pattern: catalog stubs whose metadata.hermes.upstream pointer makes `hermes skills install official/creative/` pull the live tree through OptionalSkillSource._fetch_from_upstream. Nothing is vendored. The brag stub documents that its Hyperframes path loads HeyGen's hyperframes-* domain skills by name, and that the skills guard blocks four of the five today (hyperframes-creative scores dangerous). brag-slim has no such dependency. Docs: two generated pages, two catalog rows, two sidebar lines. Credit: Shunit Haviv Hakimi (shunithaviv), upstream author. --- optional-skills/creative/brag-slim/SKILL.md | 46 ++++++++++++ optional-skills/creative/brag/SKILL.md | 59 +++++++++++++++ .../docs/reference/optional-skills-catalog.md | 2 + .../optional/creative/creative-brag-slim.md | 60 +++++++++++++++ .../skills/optional/creative/creative-brag.md | 73 +++++++++++++++++++ website/sidebars.ts | 2 + 6 files changed, 242 insertions(+) create mode 100644 optional-skills/creative/brag-slim/SKILL.md create mode 100644 optional-skills/creative/brag/SKILL.md create mode 100644 website/docs/user-guide/skills/optional/creative/creative-brag-slim.md create mode 100644 website/docs/user-guide/skills/optional/creative/creative-brag.md diff --git a/optional-skills/creative/brag-slim/SKILL.md b/optional-skills/creative/brag-slim/SKILL.md new file mode 100644 index 0000000000..85b73582fb --- /dev/null +++ b/optional-skills/creative/brag-slim/SKILL.md @@ -0,0 +1,46 @@ +--- +name: brag-slim +description: Launch video from a project or URL, upstream-maintained. +version: 0.4.0 +author: Shunit Haviv Hakimi (shunithaviv) +license: MIT +platforms: [linux, macos, windows] +metadata: + hermes: + tags: [video, launch-video, marketing, motion-graphics, share-copy] + category: creative + related_skills: [brag, hyperframes] + upstream: + repo: latent-spaces/brag + path: skills/brag-slim +--- + +# Brag Slim (upstream-maintained) + +> **Catalog stub.** This entry is maintained upstream at +> [latent-spaces/brag](https://github.com/latent-spaces/brag): the project +> ships `/brag-slim` as a single `SKILL.md` under `skills/brag-slim/`. `hermes +> skills install official/creative/brag-slim` pulls the current file live from +> that repo (quarantined and scanned like any hub install) — this directory +> holds only the catalog metadata, so the vendored copy can never go stale. + +`/brag-slim` is the lean `/brag`, written for Claude Opus 5.5: no Hyperframes, +no bundled assets. The model builds the whole launch video itself (story, +visuals, music, sound effects, mix and render) with the tools already on the +machine. It takes the current project directory or a website URL, reuses the +source's real UI, fonts and assets instead of redrawing them, and writes +`brag-output/` with the plan, the rendered video and share copy. Options: +`--tone`, `--format landscape|vertical|square`, `--duration`. + +`brag` adds the classic Hyperframes workflow, the bundled soundtrack and SFX, +and `--voice` narration (see its prerequisites). It includes this skill and +hands off to it on Opus 5.5. + +## Prerequisites + +- No fixed toolchain: the model builds with whatever is installed. In practice + that means FFmpeg for the audio mix and encode, plus a headless browser + (Node with Playwright or Puppeteer, or Chrome) to draw frames from HTML and + to capture websites that render their page with JavaScript. + +Full documentation: https://github.com/latent-spaces/brag#readme diff --git a/optional-skills/creative/brag/SKILL.md b/optional-skills/creative/brag/SKILL.md new file mode 100644 index 0000000000..21665aa693 --- /dev/null +++ b/optional-skills/creative/brag/SKILL.md @@ -0,0 +1,59 @@ +--- +name: brag +description: Project launch video via Hyperframes, upstream-maintained. +version: 0.4.0 +author: Shunit Haviv Hakimi (shunithaviv) +license: MIT +platforms: [linux, macos, windows] +metadata: + hermes: + tags: [video, launch-video, marketing, hyperframes, motion-graphics, share-copy] + category: creative + related_skills: [brag-slim, hyperframes] + upstream: + repo: latent-spaces/brag + path: skills/brag +--- + +# Brag (upstream-maintained) + +> **Catalog stub.** This entry is maintained upstream at +> [latent-spaces/brag](https://github.com/latent-spaces/brag): the project +> ships the skill directory (`skills/brag/`) with its step references, tone +> presets, bundled music and SFX library, and cue-analysis script. `hermes +> skills install official/creative/brag` pulls the current tree live from that +> repo (quarantined and scanned like any hub install) — this directory holds +> only the catalog metadata, so the vendored copy can never go stale. + +`/brag` reads the project in the current directory, commits to an angle and a +tone (`default`, `polished`, `yc-parody`, `chaotic`, `deadpan`, `cinematic`, +`app-store`, or freeform direction), storyboards a 15–25 second video, hands a +composition brief to Hyperframes, and renders `brag-output/brag.mp4` with a +best-frame poster and share copy. Options: `--tone`, `--format +landscape|vertical|square`, `--duration`, `--title`, `--no-music`, `--no-sfx`, +and `--voice` (Kokoro narration, off by default). + +On Claude Opus 5.5 it hands off to its bundled copy of `brag-slim` unless the +invocation asks for `--full` or `--voice`. + +## Prerequisites + +- Node.js 22+, FFmpeg on `PATH`, and the Hyperframes CLI (`npx hyperframes + doctor` confirms the environment). +- The Hyperframes path (`--full`, `--voice`, or any model other than Opus 5.5) + loads HeyGen's domain skills by name: `hyperframes-core`, + `hyperframes-animation`, `hyperframes-creative`, `hyperframes-keyframes` and + `hyperframes-cli`, installed with `hermes skills install + heygen-com/hyperframes/skills/`. The skills guard currently blocks four + of the five on HTML comments and credential docs in their examples + (`hyperframes-creative` scores dangerous, which `--force` cannot override), + so that path is not fully installable yet. `brag-slim` has no such + dependency. The optional `hyperframes` skill in this catalog is a + single-file port and does not provide those names. +- `uv` runs `scripts/analyze_music_cues.py` when a custom track needs beat-sync + cues; the bundled tracks ship precomputed cues. +- Installs pull ~290 files (~16 MB, mostly the bundled music and SFX) through + the GitHub contents API. Set `GITHUB_TOKEN` or sign in with the `gh` CLI + first; the anonymous limit of 60 requests an hour is too low for this bundle. + +Full documentation: https://github.com/latent-spaces/brag#readme diff --git a/website/docs/reference/optional-skills-catalog.md b/website/docs/reference/optional-skills-catalog.md index a59ba090f0..d6ea8e8c99 100644 --- a/website/docs/reference/optional-skills-catalog.md +++ b/website/docs/reference/optional-skills-catalog.md @@ -64,6 +64,8 @@ hermes skills uninstall | [**auteur**](../user-guide/skills/optional/creative/creative-auteur.md) | Design and build cinematic, award-level web pages. | | [**baoyu-article-illustrator**](../user-guide/skills/optional/creative/creative-baoyu-article-illustrator.md) | Article illustrations: type × style × palette consistency. | | [**baoyu-comic**](../user-guide/skills/optional/creative/creative-baoyu-comic.md) | Knowledge comics (知识漫画): educational, biography, tutorial. | +| [**brag**](../user-guide/skills/optional/creative/creative-brag.md) | Project launch video via Hyperframes, upstream-maintained. | +| [**brag-slim**](../user-guide/skills/optional/creative/creative-brag-slim.md) | Launch video from a project or URL, upstream-maintained. | | [**comfyui**](../user-guide/skills/optional/creative/creative-comfyui.md) | Generate images, video, and audio via diffusion workflows. | | [**concept-diagrams**](../user-guide/skills/optional/creative/creative-concept-diagrams.md) | Generate flat, minimal educational SVG visuals as HTML. | | [**creative-ideation**](../user-guide/skills/optional/creative/creative-creative-ideation.md) | Generate ideas via named methods from creative practice. | diff --git a/website/docs/user-guide/skills/optional/creative/creative-brag-slim.md b/website/docs/user-guide/skills/optional/creative/creative-brag-slim.md new file mode 100644 index 0000000000..38b87fcab8 --- /dev/null +++ b/website/docs/user-guide/skills/optional/creative/creative-brag-slim.md @@ -0,0 +1,60 @@ +--- +title: "Brag Slim — Launch video from a project or URL, upstream-maintained" +sidebar_label: "Brag Slim" +description: "Launch video from a project or URL, upstream-maintained" +--- + +{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} + +# Brag Slim + +Launch video from a project or URL, upstream-maintained. + +## Skill metadata + +| | | +|---|---| +| Source | Optional — install with `hermes skills install official/creative/brag-slim` | +| Path | `optional-skills/creative/brag-slim` | +| Version | `0.4.0` | +| Author | Shunit Haviv Hakimi (shunithaviv) | +| License | MIT | +| Platforms | linux, macos, windows | +| Tags | `video`, `launch-video`, `marketing`, `motion-graphics`, `share-copy` | +| Related skills | [`brag`](../../optional/creative/creative-brag.md), [`hyperframes`](../../optional/creative/creative-hyperframes.md) | + +## Reference: full SKILL.md + +:::info +The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. +::: + +# Brag Slim (upstream-maintained) + +> **Catalog stub.** This entry is maintained upstream at +> [latent-spaces/brag](https://github.com/latent-spaces/brag): the project +> ships `/brag-slim` as a single `SKILL.md` under `skills/brag-slim/`. `hermes +> skills install official/creative/brag-slim` pulls the current file live from +> that repo (quarantined and scanned like any hub install) — this directory +> holds only the catalog metadata, so the vendored copy can never go stale. + +`/brag-slim` is the lean `/brag`, written for Claude Opus 5.5: no Hyperframes, +no bundled assets. The model builds the whole launch video itself (story, +visuals, music, sound effects, mix and render) with the tools already on the +machine. It takes the current project directory or a website URL, reuses the +source's real UI, fonts and assets instead of redrawing them, and writes +`brag-output/` with the plan, the rendered video and share copy. Options: +`--tone`, `--format landscape|vertical|square`, `--duration`. + +`brag` adds the classic Hyperframes workflow, the bundled soundtrack and SFX, +and `--voice` narration (see its prerequisites). It includes this skill and +hands off to it on Opus 5.5. + +## Prerequisites + +- No fixed toolchain: the model builds with whatever is installed. In practice + that means FFmpeg for the audio mix and encode, plus a headless browser + (Node with Playwright or Puppeteer, or Chrome) to draw frames from HTML and + to capture websites that render their page with JavaScript. + +Full documentation: https://github.com/latent-spaces/brag#readme diff --git a/website/docs/user-guide/skills/optional/creative/creative-brag.md b/website/docs/user-guide/skills/optional/creative/creative-brag.md new file mode 100644 index 0000000000..39321584fd --- /dev/null +++ b/website/docs/user-guide/skills/optional/creative/creative-brag.md @@ -0,0 +1,73 @@ +--- +title: "Brag — Project launch video via Hyperframes, upstream-maintained" +sidebar_label: "Brag" +description: "Project launch video via Hyperframes, upstream-maintained" +--- + +{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} + +# Brag + +Project launch video via Hyperframes, upstream-maintained. + +## Skill metadata + +| | | +|---|---| +| Source | Optional — install with `hermes skills install official/creative/brag` | +| Path | `optional-skills/creative/brag` | +| Version | `0.4.0` | +| Author | Shunit Haviv Hakimi (shunithaviv) | +| License | MIT | +| Platforms | linux, macos, windows | +| Tags | `video`, `launch-video`, `marketing`, `hyperframes`, `motion-graphics`, `share-copy` | +| Related skills | [`brag-slim`](../../optional/creative/creative-brag-slim.md), [`hyperframes`](../../optional/creative/creative-hyperframes.md) | + +## Reference: full SKILL.md + +:::info +The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. +::: + +# Brag (upstream-maintained) + +> **Catalog stub.** This entry is maintained upstream at +> [latent-spaces/brag](https://github.com/latent-spaces/brag): the project +> ships the skill directory (`skills/brag/`) with its step references, tone +> presets, bundled music and SFX library, and cue-analysis script. `hermes +> skills install official/creative/brag` pulls the current tree live from that +> repo (quarantined and scanned like any hub install) — this directory holds +> only the catalog metadata, so the vendored copy can never go stale. + +`/brag` reads the project in the current directory, commits to an angle and a +tone (`default`, `polished`, `yc-parody`, `chaotic`, `deadpan`, `cinematic`, +`app-store`, or freeform direction), storyboards a 15–25 second video, hands a +composition brief to Hyperframes, and renders `brag-output/brag.mp4` with a +best-frame poster and share copy. Options: `--tone`, `--format +landscape|vertical|square`, `--duration`, `--title`, `--no-music`, `--no-sfx`, +and `--voice` (Kokoro narration, off by default). + +On Claude Opus 5.5 it hands off to its bundled copy of `brag-slim` unless the +invocation asks for `--full` or `--voice`. + +## Prerequisites + +- Node.js 22+, FFmpeg on `PATH`, and the Hyperframes CLI (`npx hyperframes + doctor` confirms the environment). +- The Hyperframes path (`--full`, `--voice`, or any model other than Opus 5.5) + loads HeyGen's domain skills by name: `hyperframes-core`, + `hyperframes-animation`, `hyperframes-creative`, `hyperframes-keyframes` and + `hyperframes-cli`, installed with `hermes skills install + heygen-com/hyperframes/skills/`. The skills guard currently blocks four + of the five on HTML comments and credential docs in their examples + (`hyperframes-creative` scores dangerous, which `--force` cannot override), + so that path is not fully installable yet. `brag-slim` has no such + dependency. The optional `hyperframes` skill in this catalog is a + single-file port and does not provide those names. +- `uv` runs `scripts/analyze_music_cues.py` when a custom track needs beat-sync + cues; the bundled tracks ship precomputed cues. +- Installs pull ~290 files (~16 MB, mostly the bundled music and SFX) through + the GitHub contents API. Set `GITHUB_TOKEN` or sign in with the `gh` CLI + first; the anonymous limit of 60 requests an hour is too low for this bundle. + +Full documentation: https://github.com/latent-spaces/brag#readme diff --git a/website/sidebars.ts b/website/sidebars.ts index b8cbf9aab2..68f1bf6f09 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -370,6 +370,8 @@ const sidebars: SidebarsConfig = { 'user-guide/skills/optional/creative/creative-auteur', 'user-guide/skills/optional/creative/creative-baoyu-article-illustrator', 'user-guide/skills/optional/creative/creative-baoyu-comic', + 'user-guide/skills/optional/creative/creative-brag', + 'user-guide/skills/optional/creative/creative-brag-slim', 'user-guide/skills/optional/creative/creative-comfyui', 'user-guide/skills/optional/creative/creative-concept-diagrams', 'user-guide/skills/optional/creative/creative-creative-ideation',