screenshot

스크린샷 스킬 개요

스크린샷 스킬이 하는 일

스크린샷 스킬은 전체 화면, 특정 창, 앱 영역, 또는 저장된 파일 경로가 필요한 작업에서 에이전트가 올바른 데스크톱 이미지를 캡처하도록 돕습니다. 브라우저 전용 캡처나 디자인 도구 캡처, 혹은 일반적인 프롬프트 답변이 아니라 실제 OS 수준의 스크린샷이 필요할 때 적합합니다.

언제 설치하는 것이 맞는가

워크플로에 데스크톱 앱, 다중 창 검토, OS UI 디버깅, 또는 도구별 캡처를 사용할 수 없는 상황이 포함된다면 screenshot을 설치하세요. 특히 시각적 증빙, 인계용 산출물, 픽셀 단위의 정확한 참조가 필요한 Workflow Automation 작업에 유용합니다.

무엇이 다른가

이 스크린샷 스킬은 단순한 명령 래퍼가 아니라 의사결정 중심으로 설계되어 있습니다. 캡처 우선순위, 저장 위치 규칙, macOS 권한 처리를 인코딩해 두었기 때문에, 에이전트가 더 적은 질문으로 더 빨리 실행 가능한 경로를 선택할 수 있습니다. 사용자가 “스크린샷 찍어줘”처럼만 말하거나 대상이 불완전하게 주어졌을 때도 추측을 줄여 줍니다.

스크린샷 스킬 사용 방법

설치하고 핵심 파일 위치를 확인하기

npx skills add openai/skills --skill screenshot로 설치한 뒤, 먼저 SKILL.md를 읽고, 그다음 scripts/take_screenshot.py, scripts/ensure_macos_permissions.sh, agents/openai.yaml를 확인하세요. 플랫폼별 동작이 필요하다면, 캡처 경로를 단정하기 전에 scripts/ 안의 Swift 헬퍼도 살펴보는 것이 좋습니다.

완전한 캡처 브리프를 제공하기

좋은 스크린샷 요청에는 대상, 영역, 출력 경로, 제약 조건의 네 가지가 들어가야 합니다. 예를 들어: “활성 Photoshop 창을 캡처해서 /tmp/review.png에 저장해 줘” 또는 “디스플레이 2의 전체 화면 스크린샷을 기본 스크린샷 폴더에 저장해 줘”처럼 말할 수 있습니다. 경로를 생략하면 스킬은 OS 기본값을 따르며, Codex가 이미지를 검사용으로 써야 한다면 임시 경로에 저장하는 편이 좋습니다.

플랫폼에 맞는 워크플로를 사용하기

브라우저, Figma, Electron의 경우에는 우선 해당 앱이나 도구의 네이티브 스크린샷 경로를 쓰는 것이 좋습니다. 이 스킬은 전체 데스크톱이 필요할 때, 앱/창 캡처가 실제 요구사항일 때, 또는 다른 도구로는 필요한 화면을 담을 수 없을 때 사용하세요. macOS에서는 창/앱 캡처 전에 권한 사전 점검을 실행해 Screen Recording 권한 요청이 반복되는 상황을 피하는 것이 좋습니다.

실전용 프롬프트 패턴

좋은 스크린샷 안내 프롬프트는 올바른 헬퍼와 출력 경로를 바로 선택할 수 있을 만큼 구체적입니다. 예: “macOS에서 스크린샷 스킬을 사용해 에디터 창의 왼쪽 절반을 캡처한 뒤 기본 스크린샷 위치에 저장해 줘.” 영역이 필요하다면 x,y,w,h 형식으로 좌표를 제공하고, 그 영역이 화면 기준인지 창 기준인지도 함께 말하세요.

스크린샷 스킬 FAQ

스크린샷 스킬은 전체 화면 캡처만 지원하나요?

아닙니다. 스크린샷 스킬은 전체 화면, 창, 앱, 영역 캡처를 모두 다룹니다. 데스크톱 전체 맥락이 정말 중요할 때만 전체 화면을 쓰고, 그렇지 않다면 대상을 좁혀 노이즈를 줄이고 활용도를 높이세요.

언제 이 스킬을 쓰지 말아야 하나요?

Figma나 브라우저 전용 워크플로처럼 더 긴밀하게 통합된 도구가 정확히 필요한 화면을 캡처할 수 있다면 이 스킬을 쓰지 마세요. 또한 실제 이미지 산출물이 필요하지 않고 텍스트 추출이나 UI 추론만이 목적이라면 이 스킬은 피하는 편이 낫습니다.

초보자도 먼저 OS 세부사항을 알아야 하나요?

아닙니다. 초보자도 “이 창 스크린샷 찍어줘”처럼 간단하게 요청해 사용할 수 있습니다. 가장 큰 개선 포인트는 대상, 저장 경로, 필요한 자르기 정보를 더하는 것입니다. 다만 macOS에서는 권한이 여전히 가장 큰 걸림돌일 수 있으므로, 한 번의 설정 단계는 예상해 두는 것이 좋습니다.

일반적인 프롬프트와 무엇이 다른가요?

일반적인 프롬프트는 원하는 이미지를 설명할 수는 있지만, 스크린샷 스킬은 캡처 선택, 저장 위치 규칙, macOS 권한 마찰까지 함께 처리합니다. 그래서 Workflow Automation에서는 추상적인 답변이 아니라 구체적인 파일 출력으로 에이전트를 유도한다는 점에서 더 신뢰할 수 있습니다.

스크린샷 스킬 개선하기

가능한 한 가장 분명한 대상을 지정하기

품질을 가장 크게 높이는 방법은 프레임 안에 정확히 무엇이 들어가야 하는지 명시하는 것입니다. “에디터를 캡처해 줘”보다 “app.py가 열려 있고 터미널이 보이는 VS Code 창을 캡처해 줘”가 훨씬 낫습니다. 비슷한 창이 여러 개 열려 있을 때는 구체적인 대상 지정이 실패한 캡처를 줄여 줍니다.

결과를 바꾸는 제약 조건을 추가하기

스크린샷에서 민감한 내용이 빠져야 하거나, 한 대의 모니터만 포함해야 하거나, 특정 해상도로 보여야 한다면 처음부터 분명히 말하세요. 영역 캡처라면 좌표를 제공하고, 자르기 범위에 크롬 영역, 제목 표시줄, 콘텐츠만 포함할지 설명하세요. 이런 세부 정보는 장황한 설명보다 훨씬 중요합니다.

첫 결과를 다음 요청에 반영하기

스크린샷이 너무 넓거나, 너무 작거나, 필요한 UI 상태를 놓쳤다면 무엇이 잘못됐는지 짚어서 대상을 더 좁히며 반복하세요. 예를 들어: “모달만 보이게 다시 찍어 줘” 또는 “상태 표시줄이 보이도록 크롭을 아래로 조금 내줘”라고 할 수 있습니다. 이런 피드백 루프가 스크린샷 사용을 가장 빠르게 개선하는 방법입니다.

흔한 실패 모드를 점검하기

가장 흔한 문제는 macOS 권한 프롬프트, 잘못된 모니터 캡처, 그리고 더 나은 도구로는 더 깔끔한 결과를 얻을 수 있는데도 스크린샷을 요청하는 경우입니다. 첫 캡처가 실패하면 앱 이름, 창 제목, 화면 번호, 정확한 영역을 추가해 요청을 보완하세요.