菜单
Create reproducible TUI screenshots and GIF demos for documentation with Betamax. Use when asked to capture terminal screenshots, record demos, or author .keys files.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/marcus/marcus-skills --skill betamax-docs命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | betamax-docs |
| description | Create reproducible TUI screenshots and GIF demos for documentation with Betamax. Use when asked to capture terminal screenshots, record demos, or author .keys files. |
Use README.md for the authoritative syntax, options, and keys file format. Keep outputs reproducible and deterministic.
Launch any command in a tmux session with a hotkey bound to capture PNG screenshots on demand.
betamax capture <command> # capture with default settings
betamax capture nvim myfile.py # capture inside neovim
betamax capture --preset docs htop # use a named preset
betamax capture --theme dracula --shadow --window-bar colorful htop
Options:
--key KEY — capture hotkey in tmux format (default: C-g / Ctrl+G)--output-dir DIR — output directory (default: ./captures)--cols N / --rows N — terminal dimensions (default: current terminal)--preset NAME — load preset from ~/.config/betamax/presets/<name>.conf--save-text — also save raw ANSI text alongside PNG--window-bar STYLE — add window bar: colorful, colorful_right, rings--border-radius N, --margin N, --padding N — decoration geometry--shadow — enable drop shadow--theme NAME — color theme (dracula, nord, catppuccin-mocha, etc.)Config files (key=value, # comments):
.betamaxrc — project config (searched up to git root)~/.config/betamax/config — global config~/.config/betamax/presets/<name>.conf — named presets.keys file with @set:cols, @set:rows, and @set:output for consistent sizing.@require:termshot for PNG or @require:termshot + ffmpeg for GIFs.@wait/@sleep to reach the desired UI state before capture.betamax "<command>" -f path/to/file.keys.The same decoration flags from betamax capture work on the main command:
betamax myapp -f demo.keys --theme dracula --shadow --window-bar colorful
betamax myapp -f demo.keys --border-radius 10 --padding 10 --margin 20
CLI flags override @set: directives in the keys file, which override .betamaxrc config.
Precedence: CLI > @set: > .betamaxrc > global config > preset > defaults.
@set:cols:120
@set:rows:30
@set:output:./docs/assets
@require:termshot
@sleep:500
@wait:Ready
@capture:tui.png
q
@set:cols:120
@set:rows:30
@set:output:./docs/assets
@require:termshot
@record:start
# ... keys with @frame where you want animation steps ...
@record:stop:tui-demo.gif
betamax record -o demo.keys <command>betamax record --gif demo.gif --auto-frame <command>