터미널 스크린샷 (ANSI → 이미지)
터미널 CLI의 컬러 출력을 PNG 이미지로 렌더링해 Claude가 실제 색상과 대비를 눈으로 확인하게 해주는 스킬.
개발·코딩중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
Claude는 보통 명령어 출력을 텍스트와 \x1b[48;2;...m 같은 원시 이스케이프 코드로만 받습니다. 그래서 "이 diff의 추가/삭제 색 대비가 충분한가?", "테마가 너무 어둡게 나왔나?" 같은 질문에 정직하게 답할 수 없습니다.
이 스킬은 두 단계로 문제를 해결합니다.
- 캡처: 실제 셸에서
--color=always,CLICOLOR_FORCE=1,script -q /dev/null등을 사용해 색상이 온전히 살아있는.ansi파일을 저장합니다. - 렌더링: 번들된
scripts/render_ansi.sh로 PNG를 생성하고(우선freeze, 없으면ansi2html.py+ 헤드리스 Chrome), Read 도구로 이미지를 읽어 색을 시각적으로 판단합니다.
핵심 원칙은 렌더러가 명령을 직접 실행하게 하지 말 것입니다. freeze --execute 는 자식 pty 환경을 감지한 delta 등이 배경 블록·줄번호를 버리게 만들어 결과가 열화됩니다. 또한 실제 터미널 배경색(예: #282c34)을 넘겨야 대비 판단이 정확합니다.
이런 분께 추천
- delta, bat, eza, starship, lazygit pager 등 CLI 색상 테마를 자주 손보는 개발자
- 다크/라이트 테마 대비와 가독성을 실제 화면 기준으로 검증하고 싶은 분
- 터미널 도구의 하이라이팅·정렬 버그를 Claude와 함께 디버깅하고 싶은 분
활용 예시
- delta 색상 수정 검증: gitconfig의
[delta]색을 바꾼 뒤git --no-pager diff | delta --dark --line-numbers --width=110 > /tmp/diff.ansi→render_ansi.sh /tmp/diff.ansi /tmp/diff.png "#282c34"→ 이미지로 추가/삭제 대비 확인. - bat 테마 비교: 같은 소스 파일을 여러 테마로 캡처해 PNG로 나란히 비교하고 어떤 테마가 가독성이 좋은지 판단.
- lazygit diff 색상 점검: 전체화면 TUI는 캡처 불가이므로, 동일한 delta 설정을 사용하는
git diff | delta결과만 따로 렌더링해 간접 검증.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-claude-code/terminal-screenshot 폴더를 내 ~/.claude/skills/terminal-screenshot/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/terminal-screenshot ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/terminal-screenshot ~/.claude/skills/ - 실행 권한을 부여합니다:
chmod +x ~/.claude/skills/terminal-screenshot/scripts/render_ansi.sh - (권장) 렌더러 freeze를 설치합니다:
brew install charmbracelet/tap/freeze또는go install github.com/charmbracelet/freeze@latest. ⚠️brew install freeze(탭 없이)는 동명의 GUI 앱이 설치되므로 사용하지 마세요. - freeze를 설치할 수 없다면 Chrome(또는 Chromium)만 있어도 됩니다. 번들된
ansi2html.py+ 헤드리스 Chrome으로 자동 대체됩니다. - 내 터미널 배경색을 확인해 둡니다. 예: Ghostty는
ghostty +show-config --default | grep '^background'. - Claude Code를 재시작한 뒤 "터미널 스크린샷으로 delta 색상 확인해줘"처럼 요청하면 스킬이 동작합니다.
GitHub에서 원본 보기 ↗라이선스: MIT