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/<name>` 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.
This commit is contained in:
Brooklyn Nicholson
2026-09-26 16:52:05 -05:00
committed by brooklyn!
parent e7b2db974c
commit a7c080ca66
6 changed files with 242 additions and 0 deletions

View File

@@ -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

View File

@@ -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/<name>`. 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

View File

@@ -64,6 +64,8 @@ hermes skills uninstall <skill-name>
| [**auteur**](../user-guide/skills/optional/creative/creative-auteur.md) | Design and build cinematic, award-level web pages. | | [**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-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. | | [**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. | | [**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. | | [**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. | | [**creative-ideation**](../user-guide/skills/optional/creative/creative-creative-ideation.md) | Generate ideas via named methods from creative practice. |

View File

@@ -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

View File

@@ -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/<name>`. 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

View File

@@ -370,6 +370,8 @@ const sidebars: SidebarsConfig = {
'user-guide/skills/optional/creative/creative-auteur', 'user-guide/skills/optional/creative/creative-auteur',
'user-guide/skills/optional/creative/creative-baoyu-article-illustrator', 'user-guide/skills/optional/creative/creative-baoyu-article-illustrator',
'user-guide/skills/optional/creative/creative-baoyu-comic', '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-comfyui',
'user-guide/skills/optional/creative/creative-concept-diagrams', 'user-guide/skills/optional/creative/creative-concept-diagrams',
'user-guide/skills/optional/creative/creative-creative-ideation', 'user-guide/skills/optional/creative/creative-creative-ideation',