클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

macOS 화면 캡처 자동화

Swift로 창 ID를 찾고 AppleScript로 화면을 조정한 뒤 screencapture로 특정 창만 정확히 캡처하는 macOS 자동화 스킬입니다.

자동화·워크플로중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

macOS에서 "특정 앱 창만" 프로그램적으로 캡처하는 3단계 워크플로를 Claude에게 가르쳐 줍니다.

  1. 창 찾기 — Swift의 CGWindowListCopyWindowInfo로 앱 이름을 검색해 숫자 Window ID(WID)를 얻습니다. (macOS에서 유일하게 신뢰할 수 있는 방법)
  2. 화면 조정 — AppleScript(osascript)로 앱을 앞으로 가져오고, Excel이라면 확대율·스크롤 행/열·시트 선택·셀 범위 선택까지 제어합니다.
  3. 캡처 — screencapture -x -l <WID> 로 소리 없이 PNG/JPEG 저장, Retina 2배 해상도는 sips로 축소합니다.

추가로 화면 기록 권한 문제 해결 순서, osascript 무한 대기를 막는 timeout 사용법, 그리고 실패로 확인된 방법들(System Events의 window id, PyObjC Quartz 등) 목록까지 정리되어 있어 시행착오를 줄여 줍니다.

이런 분께 추천

  • 매뉴얼·릴리스 노트·블로그용 스크린샷을 반복 제작하는 테크니컬 라이터
  • Excel 재무모델이나 대시보드의 여러 구간을 일정한 화면으로 캡처해 보고서를 만드는 분
  • macOS에서 시각적 QA·회귀 스크린샷을 자동화하려는 개발자
  • Claude Code에게 "화면을 보여주고" 검토받고 싶은 사용자

활용 예시

  • Excel 리포트 자동 캡처: 파일을 열고 확대율 130%로 맞춘 뒤, 1행/45행/‘DCF’ 시트를 차례로 스크롤하며 section_a.png, section_b.png, dcf_overview.png를 연속 생성.
  • 문서용 앱 창 캡처: swift scripts/get_window_id.swift Chrome으로 WID를 얻어 브라우저 창만 깔끔하게 캡처(배경 데스크톱 제외).
  • 권한 문제 진단: 캡처가 실패할 때 --permission-hint screen 체크리스트를 출력하고 시스템 설정의 화면 기록 창을 바로 열어 원인을 좁히기.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 capture-screen 폴더를 내 ~/.claude/skills/capture-screen/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/capture-screen ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 사전 준비: macOS와 Xcode Command Line Tools가 필요합니다. 터미널에서 swift --version이 동작하는지 확인하고, 안 되면 xcode-select --install을 실행하세요.
  2. 저장소 복제: 터미널에 git clone https://github.com/daymade/claude-code-skills.git ~/claude-code-skills 입력.
  3. 스킬 폴더 생성: mkdir -p ~/.claude/skills
  4. 스킬 복사: cp -r ~/claude-code-skills/capture-screen ~/.claude/skills/
  5. 확인: ls ~/.claude/skills/capture-screen 로 SKILL.md와 scripts/ 폴더가 보이는지 확인.
  6. 권한 허용: 시스템 설정 → 개인정보 보호 및 보안 → 화면 기록에서 사용 중인 터미널(Terminal/iTerm) 또는 Claude Code 앱을 활성화하고 앱을 재시작합니다.
  7. 테스트: Claude Code를 다시 실행한 뒤 "Chrome 창을 캡처해줘"처럼 요청하거나, 직접 swift ~/.claude/skills/capture-screen/scripts/get_window_id.swift Chrome을 실행해 WID가 출력되는지 확인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT