Agent skill · creative production · daymade
terminal-screenshot
MUST be used right after changing any CLI color config (delta/bat/themes/lazygit pager) — renders the terminal's colored output to a PNG so Claude can actually SEE contrast, alignment, and highlighting instead of raw ANSI codes. Use for delta git diff colors, bat syntax highlighting, starship prompt, eza/ls colors, or ripgrep matches. Trigger phrases: 看终端效果, 终端截图, 验证配色, terminal screenshot.
Why this skill is useful
Adds a specific method for capturing and rendering ANSI terminal output to PNG, which is not commonly known.
What it needs
Requires ghostty installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 1,320 stars on the source repository.
What this skill does
Terminal Screenshot Render the colored output of a terminal command into a PNG image, then read that image to judge the result visually. Why this exists When a command's output arrives as a tool result, Claude sees plain text plus raw escape codes like \x1b48;2;92;30;34m — not the rendered colors. That makes it impossible to honestly answer "is the diff's add/remove contrast strong enough?" or "did this theme come out too dark?". Reading hex values is guessing. This skill turns the output into an image so the judgement is based on what a human would actually see on screen. The method: capture, then render Two separate steps. Keep them separate — that separation is the whole trick. Step 1 — Capture full-fidelity ANSI to a file Most CLIs drop or downgrade colors when they detect they're not writing to a real terminal (a pipe or a child process). Force full coloring and save to a .ansi file. The exact flag depends on the tool — recipes below. The single most important rule: never let the renderer run the command for you. freeze --execute "git diff delta" looks convenient but produces a degraded result — delta (and lazygit, and anything that probes terminal capabilities) runs inside freeze's child pty, detects a reduced environment, and silently drops its background blocks, line-number column, and header box. Capture in a normal shell first, render second. Step 2 — Render the ANSI file to PNG, then read it Use the bundled wrapper, which prefers freeze and falls back to a stdlib renderer + headless Chrome: Then read the PNG with the Read tool and judge the colors. Background color must match the real terminal, or a dark theme verified on a white page looks wrong. On macOS with Ghostty: Pass it as #282c34. If unknown, a dark terminal is usually near #1d1f21–#282c34. Capture recipes per tool Pick a --width close to the real terminal (≈100–120) so wrapping matches. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills daymade/terminal-screenshot