How burgebj/brag works
This repository provides two agent skills for turning a project into a short launch video: the classic /brag workflow and the lean /brag-slim alternative. The principal workflow inspects the project, plans its story and tone, composes a video brief, then delegates building and rendering to Hyperframes and produces share copy. README and tree support the documented stages and optional voiceover; the skill instructions themselves were not sampled, so internal call-level wiring is shown only where documented.
Main entry points: SKILL.md /brag skill · step-3-compose.md Compose brief · step-4-deliver.md Deliver outputs · step-2-plan.md Plan story
Components 18
Creative workflow
- /brag skill
skills/brag/SKILL.md - Inspect project
skills/brag/references/step-1-inspect.md - Plan story
skills/brag/references/step-2-plan.md - Compose brief
skills/brag/references/step-3-compose.md - Deliver outputs
skills/brag/references/step-4-deliver.md - Tone guidance
skills/brag/references/tones.md - Audio guidance
skills/brag/references/audio.md
Classic assets
- Music and SFX
skills/brag/assets - Bundled cue presets
skills/brag/assets/music/cues - Music cue analysis
skills/brag/scripts/analyze_music_cues.py
Slim workflow
- /brag-slim skill
skills/brag-slim/SKILL.md - Slim instructions
skills/brag/slim.md
Video delivery
- Hyperframes CLI
- Kokoro narration
- brag-output
- Rendered brag.mp4
Other components
- Project user
- Skills agent
Connections 18
- Project user → Skills agent: requests video
- Skills agent → /brag skill: invokes skill
- Skills agent → /brag-slim skill: invokes alternative
- /brag skill → Inspect project: inspects project
- /brag skill → Plan story: plans story
- /brag skill → Compose brief: writes brief
- /brag skill → Deliver outputs: prepares outputs
- Plan story → Tone guidance: uses guidance
- Compose brief → Audio guidance: uses guidance
- Compose brief → Music and SFX: selects media
- Audio guidance → Bundled cue presets: may use cues
- Music cue analysis → Bundled cue presets: generates presets
- /brag-slim skill → Slim instructions: includes instructions
- Compose brief → Hyperframes CLI: hands off brief
- Hyperframes CLI → Rendered brag.mp4: builds and renders
- Deliver outputs → brag-output: writes deliverables
- Deliver outputs → Rendered brag.mp4: delivers video
- Kokoro narration → Hyperframes CLI: provides narration