菜单
Capture terminal screenshots and GIF recordings from tmux sessions using freeze and agg. Use when you need to screenshot a TUI app, generate terminal images, or convert asciinema casts to GIFs.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | terminal-screenshot |
| description | Capture terminal screenshots and GIF recordings from tmux sessions using freeze and agg. Use when you need to screenshot a TUI app, generate terminal images, or convert asciinema casts to GIFs. |
Capture screenshots from live tmux sessions with freeze, convert asciinema .cast files to GIFs with agg.
Capture a tmux pane and render it as a terminal image:
freeze --execute "tmux capture-pane -t $SESSION -p -e" \
--output screenshot.png --window --padding 20 \
--font.family "JetBrainsMono Nerd Font Mono"
Use the tmux-cli-testing skill's helper (tmux_test_helper.sh) to drive the app to
the desired state, then snapshot the same tmux session. This is the one harness for
driving TUIs over tmux — don't introduce a separate one.
source path/to/tmux-cli-testing/scripts/tmux_test_helper.sh
trap cleanup_test EXIT
start_test --cwd "$PROJECT" node app.js # helper creates session $TMUX_SESSION
wait_for "Ready" 30
sleep 1
# Navigate to the screen you want to capture
send_line "some input"
wait_for "Expected output" 15
sleep 1
# Capture the helper's session ($TMUX_SESSION)
freeze --execute "tmux capture-pane -t \"$TMUX_SESSION\" -p -e" \
--output shot.png --window --padding 20 \
--font.family "JetBrainsMono Nerd Font Mono"
agg --theme dracula --font-family "JetBrainsMono Nerd Font Mono" \
recording.cast output.gif
Font family must match an installed font. The default "JetBrains Mono,Fira Code,SF Mono,Menlo,..." won't match Nerd Font variants. Check installed fonts with fc-list :mono family | sort -u and use the exact name. Wrong font = broken box-drawing characters (right borders floating mid-line).
Don't use --language ansi with freeze. Use --execute to run the capture command directly — freeze handles ANSI natively via --execute. Passing --language ansi treats escape codes as syntax tokens, not terminal output.
Use dracula theme for agg, not monokai. ANSI color 90 (bright black / borderColor="gray") is invisible in monokai but visible in dracula (#6272A4). This matters for Ink TUI apps that use gray borders.
freeze --execute vs piping. Both work, but --execute is simpler and avoids issues with pipe buffering:
# Preferred
freeze --execute "tmux capture-pane -t $SESSION -p -e" --output out.png
# Also works (no --language flag!)
tmux capture-pane -t $SESSION -p -e | freeze --output out.png
Generate a standalone HTML report from a markdown file with d2 diagrams, SVGs, and syntax-highlighted code blocks. Use when the user asks for a report, a visual writeup, or a document with diagrams.
Interact with GitLab REST API using GITLAB_TOKEN - use for TODOs, repositories, CI/pipelines, MRs, issues, and other API queries
GitLab Development Kit is a folder and set of utilities that contain most of the GitLab production systems. This skill is useful for testing with local GitLab deployment and when researching how feature works in the GitLab monolith, AIGW, workhorse and other services
CRUD GitLab issues,MRs,pipelines,jobs,epics,issue comments
my projects — gitlab namespace and ID, where they live on the local drive. Use whenever a question references a project by name, alias, or path, or when you need to locate a repo locally. Keywords - project, repo, where does X live, local path, gitlab-lsp, glab, cli, vscode extension, note, task, duo cli, dotfiles.
code changes review, use this skill any time I ask you to review a change