Communitygithub.com

screen-demo

모든 웹사이트나 웹 앱의 세련된 데모 영상(및 GIF)을 코드로 제작합니다. Claude가 페이지를 분석하고 투어를 계획하면, 스크립트가 Chromium에서 부드러운 커서, 실제 클릭, 타이핑, 완화된 스크롤로 재생한 후, 중요한 부분에 확대 효과, 하이라이트 링, 캡션 및 타이틀 카드가 포함된 1920x1080(또는 세로 또는 정사각형) 영상을 렌더링합니다.

screen-demo란 무엇인가요?

screen-demo는 주어진 URL을 전문적인 데모 영상으로 변환하는 Claude Code(또는 유사 AI 에이전트)용 스킬입니다. 사용자가 "내 사이트 데모 영상을 만들어 줘", "앱을 녹화해 줘", "제품 데모", "이 페이지 화면 녹화", "README용 랜딩 페이지 GIF 만들어 줘", "이 기능이 어떻게 작동하는지 영상으로 보여 줘", "워크스루 영상" 등이라고 말할 때 사용합니다. Claude가 먼저 페이지를 검사하여 모든 클릭 가능한 요소를 식별하고, 그런 다음 일련의 단계(타이틀 카드, 캡션, 스크롤, 확대, 클릭, 타이핑, 하이라이트)를 포함하는 JSON 투어를 작성합니다. 스크립트가 이 투어를 Chromium에서 재생하고, 페이지의 자체 프레임을 30fps로 캡처하여 부드러운 애니메이션(커서 이동, 타이핑, 스크롤)을 구현하며, 최종적으로 MP4(선택적으로 GIF)를 렌더링합니다. 가로(16:9), 세로(9:16), 정사각형 형식을 지원하며, 실패한 단계를 진단하고 캡션과 확대만 수정할 수 있도록 렌더링만 다시 수행할 수 있습니다. 보안을 위해 비밀번호나 결제 정보 입력, 구매, 게시, 삭제 등을 거부하며, 쿠키 배너를 거절합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

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

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

문서

screen-demo은(는) 무엇을 하나요?

URL을 데모 영상으로 바꿉니다. 당신은 감독입니다: 페이지를 살펴보고, 투어를 JSON으로 작성하면, 스크립트가 이를 재생하고 페이지의 자체 프레임(데스크톱이 아님)을 캡처하여 영상을 편집합니다. 스크롤, 커서의 글라이드, 타이핑은 30fps로 프레임별로 캡처되어 무거운 페이지에서도 부드럽습니다. 클릭 또는 로드 후 페이지 자체적으로 발생하는 동작은 실시간 화면 캡처에서 가져옵니다.

설정 (한 번만)

  1. Python 3.10+에 Pillow와 최신 Playwright 설치: python -m pip install -U playwright pillow, 그 다음 python -m playwright install chromium.
  2. PATH에 ffmpeg 설치 (winget install ffmpeg, brew install ffmpeg).

python tests/selftest.py (로컬 페이지, 네트워크 없음, 약 1분 소요)로 확인합니다.

워크플로

  1. 영상 용도 파악: URL, 보여줄 2~4가지 항목 (히어로, 기능, 가격, 가입 흐름), 형식 (landscape 16:9는 YouTube와 README용, vertical 9:16은 Shorts와 Reels용, square), GIF 필요 여부. 사용자 자신의 사이트나 앱, 또는 공개적으로 보여줄 수 있는 페이지만 가능합니다.
  2. 페이지 검사: python scripts/demo.py inspect URL WORK [--format vertical]. 모든 WORK/page-N.jpg (뷰포트 크기로 자른 페이지, 각 클릭 가능 요소에 빨간색 번호가 표시됨)와 WORK/elements.txt를 읽습니다. 여기서 쿠키 배너나 팝업이 나타나면 투어의 첫 번째 단계에서 이를 닫습니다 ("거절" 또는 "닫기" 버튼).
  3. WORK/tour.json 작성 (형식은 references/tour-format.md 참조): 타이틀 카드, 그 다음 짧은 단계들. 좋은 투어: 제품 설명 캡션, 첫 번째 볼만한 곳으로 스크롤, 확대, 제품 작동을 보여주는 클릭이나 타이핑, 결과 하이라이트, 각 아이디어당 캡션. 15~40초. 타겟은 inspect의 번호 (#12), 또는 css=... 또는 text=... 입니다.
  4. 녹화: python scripts/demo.py record WORK/tour.json OUT [--gif]. 투어를 재생하고, 실패한 각 단계를 출력하며, OUT/demo.mp4 (그리고 OUT/demo.gif)를 렌더링합니다.
  5. 완료 전에 OUT/keys.jpg 확인: 각 단계의 프레임. 잘못된 곳에 확대, 프레임 요점을 가리는 캡션, 실패한 단계 (요소가 이동했거나 숨겨짐), 여전히 방해가 되는 배너. 캡션, 확대 또는 타이틀 카드만 변경하려면 OUT/tour.json을 편집하고 python scripts/demo.py render OUT [--gif] 실행 (새 녹화 없음); 그 외에는 다시 녹화합니다.
  6. 전달: demo.mp4 (및 GIF)의 경로, 길이, 그리고 보여주는 각 아이디어를 한 줄씩 설명.

규칙

  • 비밀번호로 로그인하지 말고, 비밀번호나 카드 번호를 입력하지 말며 (스크립트는 비밀번호 및 결제 필드를 거부함), 구매, 전송, 게시 또는 삭제하지 말고, 누군가의 개인 데이터로 양식을 제출하지 마십시오. 로그인된 영역의 데모는 사용자가 직접 테스트 계정 페이지를 제공해야 합니다.
  • 쿠키 배너는 거절합니다 (사용자가 달리 명시하지 않는 한 최소 데이터만).
  • 캡션은 짧게 유지 (3~8단어); 캡션당 하나의 아이디어; 영상 자체의 움직임이 나머지를 전달합니다.
  • 사이트를 존중: 사용자가 보여줄 수 없는 페이지의 투어는 금지.

예시

사용자: "README용으로 내 랜딩 페이지 https://example.com 의 20초 데모를 만들어 줘, 가입 화면을 보여 줘"

당신은 inspect를 실행하고, 3개의 슬라이스를 읽고, 쿠키 배너 (#2 "모두 거절"), 히어로, "시도하기" 필드 (#9) 및 가격 카드 (#21)를 확인합니다. 투어를 작성합니다: 타이틀 카드, #2 클릭, 캡션 "스스로 쓰는 노트", #9에 타이핑, #10 클릭, 결과 하이라이트, 캡션 "영원히 무료", #21로 스크롤, 확대; --gif로 녹화, keys.jpg를 열고 확대가 가격을 잘 프레임에 담았는지 확인한 후, demo.mp4 (21초), demo.gif (3MB) 및 네 가지 아이디어로 답변합니다.

관련 스킬