Communitygithub.com

데모-비디오

사용자가 '데모 녹화', '데모 영상 만들기', '워크플로 화면 녹화', 'GIF 만들기', '유튜브 영상 만들기', '음성 해설 추가', 'TTS 내레이션 추가', '자막/캡션 만들기' 또는 터미널+브라우저 워크플로를 MP4(음성+SRT) 또는 짧은 하이라이트 GIF로 만들고자 할 때 사용합니다. 창 배치, Windows 기본 해상도 캡처, 콘택트 시트로 순간 찾기, 장면 타이밍, edge-tts 내레이션, 유튜브 자막 및 GIF 크기 제한을 다룹니다.

데모-비디오란 무엇인가요?

이 스킬은 사용자가 실제 터미널, 브라우저, 또는 앱 워크플로를 녹화하여 유튜브용 MP4(음성 해설 포함, 자막은 따로 제공)와 하이라이트 GIF, 그리고 필요시 자막이 포함된 MP4로 변환하는 전 과정을 안내합니다. Windows 환경에서 고해상도 화면 캡처를 위해 Desktop Duplication API(ddagrab)를 사용하며, 창 배치, DPI 스케일링 보정, 투명 테두리 처리를 자동화합니다. 녹화 후에는 콘택트 시트를 생성하여 비디오를 스크러빙하지 않고도 특정 순간(버튼 클릭, 페이지 로드 등)을 쉽게 찾을 수 있습니다. 또한 edge-tts를 이용한 TTS 내레이션, 자동 자막 생성(.srt), 장면별 속도 조절, GIF 제작(10MB 이하, 60초 이내) 기능을 제공합니다. Claude Code, Cursor 등 다양한 AI 코딩 에이전트와 함께 사용할 수 있습니다.

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

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

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

문서

데모 비디오: 녹화, 편집, 내레이션, 자막, GIF

화면에서 실제 워크플로(터미널, 브라우저, 앱)를 다음으로 변환합니다:

  • 유튜브 컷: TTS 음성 해설이 포함된 MP4, 자막은 따로 제공(.en.srt)
  • 하이라이트 GIF: 핵심 단계만, 무음, 자막 없음, README에 넣기에 충분히 작은 크기
  • 선택적으로 자막이 포함된 MP4(자막 지원이 없는 플랫폼용)

scripts/ 디렉토리의 스크립트는 템플릿입니다. 비디오 폴더에 복사하여(녹화 파일은 수백 MB이므로 리포지토리 외부) 설정 블록을 편집하세요. 필요한 것: ffmpeg(PATH에 있거나 FFMPEG/FFPROBE 환경 변수), Python 3, pip install edge-tts (음성용).

1. 사람과 계획하기

  • 스토리를 단계별로 정하고, 어떤 단계가 사용자(클릭, 타이핑)의 것인지 vs. 대기 단계인지 확인합니다. 무엇을 눌러야 하는지 단계 목록을 작성하여 사용자가 녹화 중에 조작할 수 있도록 합니다.
  • 주제(이슈, 할 일)를 선택하여 시각적으로 보여줄 수 있도록 합니다.
  • 무대를 정리합니다: 데모가 생성하는 것의 중복을 제거하고, 개인 탭을 닫고(새 브라우저 창을 열어 해당 사이트만 띄움), 알림을 숨깁니다. 방해가 되는 요소(업데이트 배너 등)에 대해 언급합니다.
  • 사용자가 녹화 중에 Claude에게 입력하는 모든 내용이 화면에 보인다는 점을 알려주고, "다음" / "완료" 정도로만 유지하도록 합니다.

2. 두 창을 하나의 캡처 박스에 배치하기

데모에 사용되는 모든 창을 정확히 동일한 사각형(1920×1080이 기본값)에 배치하고 해당 박스를 녹화합니다: 앞에 있는 창이 장면이 되므로, 창 전환이 편집이 됩니다.

Windows에서는 scripts/rec.ps1 place -X <px> -Y <px> 명령을 사용합니다. 주의할 점:

  • DPI 스케일링: DPI 인식 프로세스가 아닌 곳에서 좌표를 가져오면 스케일링됩니다(125%에서 "1920" 창은 실제 1536픽셀). place는 모니터별 DPI 인식(SetThreadDpiAwarenessContext(-4))을 설정하므로 모든 것이 물리적 픽셀입니다. rec.ps1 monitors로 모니터를 나열하세요.
  • 보이지 않는 테두리: Windows 10/11 창에는 약 7픽셀의 투명 테두리가 있습니다. DWM 표시 경계(DWMWA_EXTENDED_FRAME_BOUNDS)로 크기를 측정하고, GetWindowRect는 사용하지 마세요. place가 측정 및 보정합니다.
  • 녹화 전에 한 프레임을 캡처하여 확인하세요(PNG 파일 읽기).

3. 녹화하기

scripts/rec.ps1 start <이름> / stop / mark <텍스트> 명령을 사용합니다. 참고:

  • gdigrab은 DPI 인식이 아니며 스케일링된 모니터에서 축소된 데스크톱을 캡처합니다(__COMPAT_LAYER=HighDpiAware로도 해결되지 않음). Desktop Duplication(ddagrab)을 사용하세요. 이는 모니터당 기본 픽셀을 제공합니다. offset_x/y는 해당 모니터를 기준으로 합니다.
  • 두 번째 GPU(노트북 + 외부 디스플레이)에 연결된 모니터는 어댑터 0에 없습니다: -init_hw_device d3d11va=dx:<adapter> -filter_hw_device dx를 -filter_complex의 ddagrab=output_idx=<n>와 함께 사용하세요. rec.ps1 start는 -Adapter와 -Output을 인수로 받습니다. "Failed to enumerate DXGI output" 오류 발생 시 0/1을 시도해보세요.
  • MPEG-TS(-f mpegts) 형식으로 기록하세요. 프로세스를 종료하여 녹화를 중단하면 MP4/MKV는 헤더가 손실됩니다.
  • 자연스러운 중단점(설정 / 사용자 입력 / 긴 대기)에서 클립을 분할합니다. 느린 프로세스의 긴 테이크는 괜찮습니다. 편집 시 대기 구간을 빠르게 합니다.
  • 사용자가 조작하는 동안, 각 백그라운드 단계에서 보고하는 내용과 다음에 눌러야 할 것을 간략히 전달합니다.

4. 순간 찾기

비디오를 스크러빙하지 마세요. 타임스탬프가 있는 콘택트 시트를 생성하여 읽습니다: python scripts/sheets.py <clip.ts> --every 10 (전체 클립), 그 다음 각 클릭 주변에서 --from 170 --to 236 --every 2 --crop 900:560:1020:0로 제안이 나타나거나, 버튼이 눌리거나, 페이지가 로드되는 정확한 초를 찾습니다. 각 단계에 대해 (클립, 시작, 종료)를 기록하고, 대기 구간도 표시합니다.

5. 내레이션

lines.txt: 각 장면(스토리의 한 단계)당 한 줄씩, 자막 텍스트로 작성합니다. 구어체 영어, 짧은 문장, '무엇' 뿐만 아니라 '이유'를 설명합니다. voice.py에는 기호를 어떻게 발음할지(#92 → "ninety-two", /goal-new → "goal new", CI → "C I") 매핑된 SAY 맵이 있습니다. 자막은 원본을 유지합니다. 기본 음성은 en-US-AndrewNeural (+4%). 음성 목록은 python -m edge_tts --list-voices로 확인합니다. 특정 줄만 다시 음성화하려면 --only N을 사용합니다.

6. 빌드

scripts/build.py: SCENES는 장면 목록이며, 각 장면은 세그먼트 (clip, start, end, speed)의 목록입니다:

  • 사용자의 클릭은 1–2배속; 브라우저 페이지는 2–4배속; 머신 작업은 6–40배속으로, ▶▶ N× 배지 표시(속도가 3 이상일 때 그려짐);
  • LEAD + 해당 줄 길이 + TAIL보다 짧은 장면은 마지막 프레임을 유지(tpad)하여 음성이 넘치지 않도록 합니다;
  • 출력물: youtube/<이름>-youtube.mp4 (비디오 + 음성, -c copy), youtube/<이름>-youtube.en.srt (각 줄이 약 70자 단위로 분할되어 문자 비율로 시간 조정), 썸네일.
  • --burn 플래그를 사용하면 <이름>-captioned.mp4에 자막이 포함된 버전도 생성합니다.
  • 목표 길이는 1.5–3.5분입니다. 내레이션 사이에 긴 침묵이 생기면 단어를 늘리는 대신 장면 속도를 높이세요.

7. GIF

GIF는 비디오를 그대로 축소한 것이 아닙니다. 핵심 단계만 포함합니다. scripts/gif.py: HIGHLIGHTS = (clip, start, end, speed, crop), 각각 3–7초, 크롭(프레임의 1280×720 영역: 창, 웹 페이지, 메뉴) 후 960×540, 8fps, 단일 팔레트(palettegen stats_mode=diff, paletteuse dither=none diff_mode=rectangle). 자막, 배지 없음. 10MB(GitHub 이미지 제한) 이하, 약 60초 이내로 유지합니다. 각 하이라이트의 마지막 프레임을 타일로 배열하여 이미지를 읽어 확인합니다.

8. 전달

비디오 폴더에 README.md를 작성합니다: 비디오 내용, 출력물 표, 각 소스/스크립트 설명, 녹화자의 프레임 및 캡처 관련 특이사항, 재빌드 방법(음성 재생성 → 빌드 → gif)을 포함합니다. 폴더 위치를 기억에 저장하겠다고 제안합니다.

관련 스킬