terminal-screenshot
An agent skill by daymade, from daymade/claude-code-skills. Tags: cli, debugging, design, validation, visual-art.
What it does
Render a terminal CLI program's colored output to a PNG so Claude can actually SEE the real visual result — color contrast, alignment, background blocks, highlighting — instead of only reading plain text and raw ANSI escape codes. Use this whenever verifying or debugging how a CLI tool looks in the terminal: delta git diff colors, bat syntax highlighting, starship prompt, eza/ls colors, git diff, ripgrep matches, or any ANSI-colored output. ALWAYS use it right after changing any CLI color config (delta / bat / themes / lazygit pager) to visually confirm the result rather than guessing from hex values — reading a hex code is not the same as seeing the rendered contrast on the real terminal background. Trigger phrases: 看终端效果, 终端截图, 验证配色, 配色对比, 终端真实效果, terminal screenshot, render terminal output, ANSI to image, "does this color look right", "is the contrast enough", delta/bat color verification.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add daymade/claude-code-skills --skill terminal-screenshot
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/daymade-claude-code/terminal-screenshot ~/.claude/skills/terminal-screenshot
Safety box score
Grade C, moderate risk: 28 of 100 risk points, rated 2026-09-22. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill renders captured ANSI terminal output into PNGs for visual inspection, using either a local `freeze` binary or a headless Chrome fallback. The main risks are install-time downloads of third-party tools and the fact that it executes external binaries and writes a companion HTML file during rendering.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 1 (low) | It runs local programs to do the render, e.g. `"$FREEZE" --background "$BG" -o "$OUT" < "$ANSI"` or headless Chrome in `scripts/render_ansi.sh`. |
| Network access | 2 (moderate) | The install instructions fetch tools from outside the machine, including `brew install charmbracelet/tap/freeze` and `go install github.com/charmbracelet/freeze@latest`. |
| Filesystem reach | 1 (low) | Rendering writes output files on disk, including `"${OUT%.png}.html"` in `scripts/ansi2html.py` and the requested PNG in `scripts/render_ansi.sh`. |
| Secrets & credentials | 0 (none) | The files do not read or request tokens, keys, passwords, dotfiles, or credential stores. |
| Privilege & persistence | 2 (moderate) | The skill explicitly instructs installing software via Homebrew or Go into the user/system environment (`brew install ...`, `go install ...`), which changes the local machine outside the repo. |
| Instruction hijack surface | 0 (none) | There is no instruction to ignore higher-level policy, hide actions, or follow remote prompt text; the warning against `freeze --execute` is a safety guard, not prompt injection. |
| Irreversible actions | 0 (none) | It only renders files to images; it does not post, deploy, delete, pay, or otherwise act on behalf of the user. |
| Transparency | 1 (low) | The preferred renderer is pulled from outside the repo with `go install github.com/charmbracelet/freeze@latest`, so the actual binary is not fully reviewable from these files. |
Before installing
- Read `SKILL.md` for the `freeze` install path and decide whether you accept a Homebrew/Go download.
- If you may use the fallback, confirm Google Chrome is installed at the expected path.
- Run the renderer first on a harmless sample in a scratch output directory.
- Check whether creating a companion `.html` file next to the PNG is acceptable for your workspace.
Rated 2026-09-22 by an automated review of 3 files from the skill's repository.
Source
- Repository
- daymade/claude-code-skills (all skills from this repository)
- Path
- daymade-claude-code/terminal-screenshot/SKILL.md
- Branch
- main
- Updated
- 2026-09-20
Related skills
- check-compiler-errors — Run compile and type-check commands and report failures
- control-cli — Build or adapt a local harness to drive, inspect, and profile an interactive CLI or TUI without external services.
- E2E Testing Nori Skillsets Subcommands — Use when you need to interactively test a nori-skillsets CLI subcommand end-to-end via tmux, with full filesystem isolation
- frontend-ui-engineering — Builds production-quality, accessible, responsive user-facing UIs.
- TUI Puppeteering with tmux — Use when automating or testing TUI/CLI applications - provides isolated tmux sessions with scripts for input, output capture, and state verification
- vitest — Vitest fast unit testing framework powered by Vite with Jest-compatible API.