Communitygithub.com

shotglass

macOS에서 ShotGlass를 사용하여 앱 및 브라우저 데모를 녹화합니다. '데모 촬영', '워크스루 녹화', '이 앱 사용법 보여주기'와 같은 요청에 사용되며, 기존 ShotGlass 프로젝트를 편집하거나 내보낼 때도 사용합니다.

shotglass란 무엇인가요?

ShotGlass는 macOS에서 앱 및 브라우저 데모 녹화를 자동화하는 AI 에이전트 스킬입니다. 사용자가 '데모를 촬영해줘', '워크스루를 녹화해줘'와 같은 자연어 요청을 하면, ShotGlass MCP 서버에 연결된 도구들을 사용하여 데모를 준비하고, 비트(beats) 단위로 구성된 동작 시퀀스를 제출하면 ShotGlass가 자동으로 화면을 촬영하고 창을 복원하며 편집기를 엽니다. 주요 기능으로는 새 데모 녹화, 비디오 렌더링, 자동 스타일링 적용, 기존 프로젝트 편집이 있습니다. macOS에서만 작동하며, ShotGlass 앱과 MCP 서버가 모두 동일한 Mac에서 실행되어야 합니다. 프록시나 호스트 액션 루프 없이 하나의 ShotGlass 인스턴스를 재사용하고 계획된 동작을 한 번에 제출하는 방식을 권장합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jakemanger/shotglass-skills/tree/main/skills/shotglass

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

shotglass은(는) 무엇을 하나요?

ShotGlass의 연결된 MCP 도구를 통해 촬영합니다. 도구 이름과 매개변수는 설치된 서버의 최신 스키마를 사용하세요.

시작하기

새 데모의 경우 두 번의 호출을 사용합니다:

  1. recording_prepare({app:"Notes", allowSystemDisplayPrompt:true}) — 요청된 앱으로 대체합니다. 반환된 스크린샷, refs 및 snapshotId를 읽습니다.
  2. compose({snapshotId, beats}) — 전체 시퀀스를 한 번에 제출합니다. ShotGlass가 촬영하고, 창을 복원하며, 프로젝트를 편집기에서 엽니다.

반환된 상태로 비트를 구성합니다: {ref:"<반환된 ref>"}, {type:"text"}, {key:"cmd+s"}, 또는 {point:{x,y},action:"click"}. 플레이스홀더는 실제 반환된 값으로 대체합니다. 스크린샷 좌표는 screenshot.origin + 이미지 좌표입니다. 대화상자에는 안정적인 키보드 탐색을 사용하고, 데모 작업이 파일을 저장하는 경우 expectedFiles를 포함합니다.

요청된 내용을 전달하세요

  • 데모 촬영: 스타일링 및 출력 옵션을 설정하지 않은 상태로 둡니다. 원래 프레이밍과 편집 가능한 커서를 유지한 후 편집기를 엽니다.
  • 촬영 및 렌더링: 동일한 compose 호출에서 output:{mode:"video"}를 설정합니다. 반환된 delivery.videoPath를 보고합니다.
  • 자동 스타일링 또는 확대/축소 적용: 요청된 경우에만 naturalStyle:true를 설정합니다.
  • 기존 녹화 편집: 의도한 프로젝트를 편집기 도구로 검사한 후 요청된 편집을 적용합니다. 요청된 경우에만 렌더링합니다.

배경 작업에는 refs를 선호합니다. 좌표 동작은 실제 입력이 필요할 수 있습니다. allowRealInput:true는 기존 사용자 승인이 있는 경우에만 설정하고, 그렇지 않으면 ShotGlass가 승인을 요청하도록 합니다. 호스트 액션 루프나 다른 레코더를 사용하지 않고 하나의 ShotGlass 인스턴스를 재사용하고 계획된 동작을 함께 제출합니다.

차단된 경우

도구가 누락된 경우 설정을 읽으세요. 앱과 MCP 서버는 촬영 중인 Mac에서 실행되어야 합니다.

권한, 알림 또는 취소로 인해 촬영이 중단된 경우 반환된 프로젝트를 보존하고 특정 차단 요소를 보고합니다. 사용자 데이터를 변경하는 알림을 무분별하게 재시도하거나 해제하지 마십시오. 두 번의 호출 경로는 준비되고 계획 가능한 데모에 적용되며, 실패한 테이크가 완료된 것처럼 가장할 필요는 없습니다.

관련 스킬