Agent skill

Terminal Screenshot

by daymade in daymade/claude-code-skills

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…

MITAuto-check passedDevelopment

Install Terminal Screenshot

skills CLI
$ npx skills add daymade/claude-code-skills --skill terminal-screenshot -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install daymade/claude-code-skills terminal-screenshot --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/daymade/claude-code-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/daymade-claude-code/terminal-screenshot .claude/skills/terminal-screenshot && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
terminal-screenshot
GitHub stars
1.4k
Token cost
~1.6k tokens
SKILL.md length
756 words
Files
3 (incl. scripts)
Skills in repo
104
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 2 steps: Capture full-fidelity ANSI to a file → Render the ANSI file to PNG, then read it
  • Delta git diff colors
  • SKILL.md covers Why this exists, The method: capture, then render, Capture recipes per tool and TUI programs (lazygit, htop,…, plus 3 more sections
  • Runs Python and Shell scripts from its folder; calls git, go and brew

What it does

Terminal Screenshot is an agent skill from daymade/claude-code-skills. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/ansi2html.py` and `scripts/render_ansi.sh`).

It sits in Development. It works with Git. The repository describes itself as: Professional Claude Code skills marketplace featuring production-ready skills for enhanced development workflows. The licence is MIT.

When your agent uses it

  • Delta git diff colors
  • Bat syntax highlighting
  • Starship prompt
  • Ripgrep matches

Example prompts

  • “/terminal-screenshot”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Capture full-fidelity ANSI to a file
  2. Render the ANSI file to PNG, then read it

What it can do on your machine

Read from SKILL.md and the folder at commit 0e52df5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • go
    • brew
    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Terminal Screenshot loads about 1.6k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 756 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from daymade/claude-code-skills at commit 0e52df5, republished under its MIT licence (© daymade). 756 words, ~1,637 tokens.

Download SKILL.mdSave it as .claude/skills/terminal-screenshot/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
terminal-screenshot
description
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.

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 \x1b[48;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:

bash
scripts/render_ansi.sh <input.ansi> <output.png> [background_hex]

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:

bash
ghostty +show-config --default | grep '^background'   # e.g. 282c34 (the default)

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.

ToolCapture command (writes full-color ANSI)
delta (git diff)git --no-pager diff | delta --dark --line-numbers --width=110 > /tmp/x.ansi
git diff (native)git -c color.ui=always --no-pager diff > /tmp/x.ansi
batbat --color=always --style=numbers <file> > /tmp/x.ansi
ezaeza -la --color=always --icons > /tmp/x.ansi
ls (GNU)ls -la --color=always > /tmp/x.ansi
ls (macOS/BSD)CLICOLOR_FORCE=1 ls -laG > /tmp/x.ansi
ripgreprg --color=always 'pattern' <path> > /tmp/x.ansi
anything elseCLICOLOR_FORCE=1 <cmd> > /tmp/x.ansi or <cmd> --color=always, or wrap in a real pty: script -q /dev/null <cmd>

Note delta always emits its configured colors even to a file, so the only trap for delta is Step 1's rule (don't render it via freeze --execute).

Full example: verify a delta color change
bash
# after editing [delta] colors in gitconfig, in any repo with a diff:
git --no-pager diff | delta --dark --line-numbers --width=110 > /tmp/diff.ansi
scripts/render_ansi.sh /tmp/diff.ansi /tmp/diff.png "#282c34"
# then: Read /tmp/diff.png and judge whether add/remove contrast is clear
Show full SKILL.md (332 more words)Show less

TUI programs (lazygit, htop, top) — out of scope

Full-screen TUIs paint with cursor positioning, not a linear ANSI stream, so they can't be captured this way. To check a TUI's colors, verify the underlying piece in isolation — e.g. for lazygit's diff, render git diff | delta as above (lazygit calls the same delta config). For a true TUI screenshot, run it in a real terminal and capture the screen (a screencapture/computer-use task), not this skill.

Installing freeze (the preferred renderer)

freeze is charmbracelet/freeze — it renders ANSI to PNG/SVG/WebP with faithful background blocks and nice chrome.

Do not run brew install freeze — that installs an unrelated GUI app of the same name (a cask). The CLI lives in charmbracelet's tap or via go install:

bash
# Option A — Homebrew tap (needs GitHub reachable)
brew install charmbracelet/tap/freeze

# Option B — go install (works behind a firewall via a Go module mirror)
GOPROXY=https://goproxy.cn,direct GOSUMDB=off \
  go install github.com/charmbracelet/freeze@latest
# binary lands in "$(go env GOPATH)/bin/freeze"

GOSUMDB=off is needed when the checksum database (sum.golang.org) is unreachable and go install hangs on "verifying module ... 504".

If freeze can't be installed, the wrapper automatically falls back to the bundled scripts/ansi2html.py (stdlib only) + headless Chrome — no extra dependency beyond a Chrome install. The fallback uses a fixed window size; widen --window-size in render_ansi.sh if output is clipped.

Bundled scripts

  • scripts/render_ansi.sh — render a captured .ansi file to PNG (freeze, else Chrome fallback). This is the entry point; call it after Step 1.
  • scripts/ansi2html.py — stdlib ANSI→HTML converter used by the fallback path. Handles 24-bit truecolor, 256-color, bold, and resets, preserving background color blocks (the part naive renderers drop).

Common pitfalls

  • Letting the renderer run the command (freeze --execute "delta …") → degraded output. Capture in a normal shell first, render the file second.
  • Non-TTY strips color → force it (--color=always / CLICOLOR_FORCE=1 / script -q /dev/null).
  • Wrong background color → a dark CLI theme rendered on a white page misjudges contrast. Use the real terminal background.
  • Light/dark mismatch → if the terminal is dark, the CLI's colors must be its dark variant. Verifying a light=true config against a dark terminal shows inverted, hard-to-read colors (and is itself the bug, not the renderer's fault).
  • brew install freeze installs the wrong (GUI cask) tool — use the tap or go install.

© daymade, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in daymade-claude-code/terminal-screenshot of daymade/claude-code-skills.

  • SKILL.md
  • scripts/ansi2html.py
  • scripts/render_ansi.sh

Open the folder on GitHubat commit 0e52df5

Compare with similar skills

Terminal Screenshot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Terminal Screenshot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Terminal Screenshot this skilldaymade/claude-code-skills1.4k—~1.6kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins11k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Finishing A Development Branchfarm-fe/farm5.6k34 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    11k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 34 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed

More from daymade/claude-code-skills

All 104 skills in this repo
  • Video Comparer

    daymade/claude-code-skills

    This skill should be used when comparing two videos to analyze compression results or quality differences.

    1.4k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check: notes
  • CLI Demo Generator

    daymade/claude-code-skills

    Generates professional animated CLI demos as GIFs using VHS terminal recordings.

    1.4k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Doc To Markdown

    daymade/claude-code-skills

    Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.

    1.4k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Interaction Design Board

    daymade/claude-code-skills

    Generates several distinct, clickable HTML interaction prototypes for one product surface into a Design Board and collects selection/remix feedback before implementation.

    1.4k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Skill Creator

    daymade/claude-code-skills

    Creates, edits and benchmarks skills; supersedes the official skill-creator plugin, so when both are listed, use this one.

    1.4k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Auto Repo Setup

    daymade/claude-code-skills

    Diagnoses and repairs repository setup and guarded Git workflows for Claude Code or Codex — environment repair, startup sync, hook auditing, collaborator handoff.

    1.4k GitHub stars~2.9k tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about Terminal Screenshot

What does Terminal Screenshot do?

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…. Terminal Screenshot is an agent skill from daymade/claude-code-skills. 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.

When should I use Terminal Screenshot?

Terminal Screenshot fits situations like: delta git diff colors; bat syntax highlighting; starship prompt; ripgrep matches.

How do I install Terminal Screenshot in Claude Code?

Run `npx skills add daymade/claude-code-skills --skill terminal-screenshot -a claude-code`. Or copy the skill folder (daymade-claude-code/terminal-screenshot in daymade/claude-code-skills) into .claude/skills/terminal-screenshot in your project. Claude Code loads it when a task matches its description.

How do I install Terminal Screenshot in Codex?

Run `npx skills add daymade/claude-code-skills --skill terminal-screenshot -a codex`. Or copy the skill folder (daymade-claude-code/terminal-screenshot in daymade/claude-code-skills) into .agents/skills/terminal-screenshot in your project. Codex loads it when a task matches its description.

Can I use Terminal Screenshot in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add daymade/claude-code-skills --skill terminal-screenshot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/terminal-screenshot, .gemini/skills/terminal-screenshot, .github/skills/terminal-screenshot and .opencode/skills/terminal-screenshot in your project.

What does Terminal Screenshot need to run?

Going by SKILL.md and its folder, Terminal Screenshot needs Python and a shell for the scripts in its folder and the command-line tools its instructions call (git, go, brew and rg). Our summary lists: Python 3; A Bash shell.

Does Terminal Screenshot access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Terminal Screenshot safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Terminal Screenshot use?

Terminal Screenshot is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Terminal Screenshot use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Terminal Screenshot?

Skills that share tags, products or a category with Terminal Screenshot: Finishing a Development Branch (obra/superpowers, 297k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Code Design Rationale Investigator (cursor/plugins, 11k stars) and Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Terminal Screenshot?

daymade (a GitHub user) maintains it in daymade/claude-code-skills, which has 1,448 GitHub stars. The repository holds 104 skills in this directory. The repository was last updated on October 10, 2026.

Source: daymade/claude-code-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.