Communitygithub.com

rnijhara/claude-skills

브라우저 기반 제품(웹 앱, 대시보드, 내부 도구, 임베디드 아티팩트)의 내레이션이 포함된 챕터별 1080p MP4 데모 또는 워크스루 비디오를 제작합니다. 실제 Chrome UI를 구동하며 온스크린 커서, 하이라이트 링, 메모 및 타이틀 카드를 표시하고, TTS(Amazon Polly 또는 macOS say)로 장면 스크립트를 음성화하며, 모든 동작을 내레이션에 맞춰 타이밍하고, 로딩 대기를 제거하며, 결과물을 믹싱, 노멀라이즈 및 챕터링합니다.

claude-skills란 무엇인가요?

이 스킬은 브라우저 기반 제품의 고품질 데모 비디오를 코드 기반으로 제작할 수 있게 해줍니다. 스크립트를 코드로 작성하기 때문에 모든 테이크가 반복 가능하며, 음성 변경이나 레이블 수정이 필요할 때 자동으로 재녹화됩니다. Chrome, Playwright, ffmpeg, Python 3, AWS CLI(Polly 용)를 필요로 하며, macOS에서도 오프라인 TTS를 지원합니다. 주요 기능으로는 자동 음성 생성(Amazon Polly 또는 macOS say), 화면 커서 및 하이라이트 링 오버레이, 로딩 시간 자동 제거, 오디오 노멀라이제이션(-16 LUFS), 챕터 생성, 그리고 오류 발생 시 자동 재녹화가 있습니다. 사용자는 `script.cjs` 파일에 장면 스크립트를 작성하고, 명령어 한 줄로 전체 비디오 생성 파이프라인(음성 생성 → 녹화 → 후처리 → 검토)을 실행할 수 있습니다.

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

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

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

문서

브라우저 데모 비디오

비디오를 코드로 스크립트화하므로 테이크가 반복 가능합니다. 음성 변경이나 레이블 하나 수정되면 자동으로 재테이크되며, 수동 재녹화가 필요 없습니다. 파이프라인:

script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
     │                                │
     └──────────record.cjs◀───────────┘   Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
                    │
               post.py  ──▶ MP4 (cuts removed, narration + click sounds, −16 LUFS, chapters)
                    │
               review.py ──▶ contact sheets + loudness/chapter check → you inspect, then deliver

엔진: 이 스킬의 scripts/ 디렉토리. 비디오별 프로젝트: ~/Movies/Demos/<slug>/ (/tmp는 절대 사용하지 않음, 지워질 수 있음). video.config.cjs, script.cjs, audio/, takes/ 디렉토리를 포함합니다. 실행 가능한 예제: examples/hello-orders/ (호스트 셸에 임베디드된 작은 페이지; 설정 확인에 사용). 첫 번째 테이크 전에 references/lessons.md를 읽으세요.

요구사항: Chrome, Node(Playwright 포함, record.cjs가 자동 찾거나 설정에서 playwright 지정), ffmpeg/ffprobe, Python 3, Polly용 AWS CLI.

1. 비디오 합의 (코드 작성 전)

확인하고 사용자가 반응할 수 있는 개요를 제안하세요:

  • 대상 시청자. 내부 비디오는 역할, 권한, 컨트롤 및 알려진 제한을 다루고, "알아야 할 사항" 챕터로 끝납니다. 리더십 및 고객 비디오는 결과와 해피 패스만 다룹니다.
  • 전체 흐름, 챕터별로, 목표 길이. 내부 심층 분석에는 약 10–12분이 적합했습니다.
  • 녹화 위치 (결정). 워크스루는 실제 버튼을 클릭하고 실제 상태를 기록하므로, 실제 공유 데이터에서는 실행되지 않습니다. 복사본, 테스트 워크스페이스, 또는 현실적인 데이터가 있는 개발 환경과 테이크 간 초기화 방법을 권장합니다. 해당 복사본이 프로덕션에 기록된다면 명시적 동의가 필요합니다.
  • 신원 (결정). 흐름에 두 명(제작자와 검토자)이 필요한 경우, 실제 팀원이 두 번째 창에 로그인하거나, 한 사람이 두 역할을 모두 수행하고 비디오에서 화면에 표시합니다. 사용자를 생성하거나 비밀번호를 처리하지 마십시오. 테스트 계정이 필요하면 사용자가 직접 생성합니다.
  • 음성 (결정). 기본값은 Polly 생성 "Amy" (en-GB)이며, 실제 시청자에게 잘 반응했습니다. 모든 것을 생성하기 전에 각 후보 음성의 약 30초 샘플을 제공하세요: aws polly synthesize-speech --profile <dev profile> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<제품 용어가 포함된 구절>" sample-Amy.mp3 비프로덕션 AWS 계정을 사용하세요. macOS say는 오프라인에서 작동하지만 합성음처럼 들립니다. 사용자 자신의 목소리가 가장 자연스러운 옵션입니다.
  • 프레이밍. 프레임에는 제품만 표시됩니다: 호스트 사이드 패널, 목록, 배너는 없습니다. 설정의 setup 훅에서 설정하세요.

2. 프로젝트 설정

P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/

video.config.cjs에서 다음을 입력하세요: 일회용 환경의 url, 제품이 iframe에서 실행되면 frame, ready, setup(프레이밍), theme(제품 강조 색상 및 푸터), voice, helpers.waitLoaded(제품의 로드 완료 신호).

단계를 작성하기 전에 UI를 매핑하세요. 열고, 안정적인 선택자(id, roles, data-*, 표시 텍스트)를 나열하고, 느린 로드를 기록하세요. 생성된 키보다 표시된 텍스트(tr:has-text("-1,250.00") [data-resolve])에 기반한 선택자를 선호하세요.

3. 장면 스크립트 작성

각 단계에는 { id, chapter?, pre?, say?, act?, gap? }이 있습니다. h API는 templates/script.cjs 상단에 문서화되어 있습니다.

  • 내레이션이 타이밍을 결정합니다. act는 클립이 재생되는 동안 실행되며, h.at(0.6)는 두 번째 액션을 단어와 맞춥니다. 각 say는 한두 문장으로 유지하세요.
  • 숫자는 말하는 대로 작성하세요 ("ninety-seven percent", "the fourteenth of September").
  • 실제 사용자의 실제 결정을 사용하세요. 가능한 경우, 화면의 수치가 팀이 알고 있는 것과 일치하도록 합니다.
  • 각 챕터 앞에 챕터 카드(h.card)를 배치하고, 3–6단어 레이블이 있는 링을 추가하세요. note()는 안전 속성, 주의 사항 또는 "실제 사용 시…"와 같이 설명이 필요한 경우에만 사용하세요.
  • 모든 느린 로드는 h.cut(() => h.waitLoaded(), 'Loading …')로 감싸세요. 해당 구간은 후반 작업에서 제거됩니다.
  • 화면과 내레이션에서 모든 단순화를 설명하세요. 예를 들어, 한 사람이 두 역할을 수행하는 경우: 이를 제어하는 컨트롤을 보여주고, "이 녹화만을 위해" 설정을 변경하고, 실제 사용에서 어떻게 되는지 설명하세요.
  • 다운로드를 가리키되 클릭하지 마세요 (lessons 참조).

4. 음성 생성

node $K/scripts/tts.cjs "$P". 변경된 줄만 재생성됩니다. Claude는 결과를 들을 수 없으므로, 위험한 단어(약어, 이름)를 명시하고 사용자에게 확인을 요청하세요. macOS say를 사용하는 경우, 약어를 문자로 철자하세요 ("S A P").

5. 드라이 런, 로그인, 녹화

  1. 드라이 런. TARGET=preview로 설정하고 previewUrl을 로컬 빌드(있는 경우)로 지정하세요. 그렇지 않으면 일회용 환경에서 짧은 세그먼트를 실행하세요: ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Read 도구로 몇 개의 프레임을 확인하세요(takes/prod/frames/*.jpg, 오류 시 failure.png), ffprobe로 프레임이 1920×1080인지 확인하세요. 이후 환경을 초기화하세요.
  2. 로그인. node $K/scripts/record.cjs "$P" login을 run_in_background와 함께 실행하세요. 사용자가 열린 창에서 로그인한 후 닫습니다. 사용자가 완료했다고 말했지만 창이 열려 있으면 pkill -INT -f "record.cjs.* login".
  3. 전체 테이크. 환경을 초기화한 후, node $K/scripts/record.cjs "$P" record를 run_in_background와 함께 실행하세요. 시작하기 전에, 사용자에게 내레이션 길이의 약 1/3이 추가로 소요되며, 보이는 Chrome 창을 클릭하지 말아야 한다고 알려주세요. 완료 알림을 기다리세요; sleep으로 폴링하지 마세요. 로그에서 모든 ok 단계와 FAILED 또는 CRASHED 줄이 없는지 확인하세요.

6. 조립 및 검토

python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4"        # run_in_background; 10분 비디오에 약 10분 소요
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review"   # 선택사항: step_id:0.8 picks

모든 review/s*.jpg 시트를 읽으세요. 잘린 레이블이나 겹치는 레이블, 잘못된 요소의 링, 제거되지 않은 로딩 상태, 남은 오버레이를 확인하세요. 음량은 약 -16 LUFS, 챕터 수는 스크립트와 일치해야 합니다. 스크립트에서 문제를 수정하고, 환경을 초기화한 후 재테이크하세요. 재테이크는 저렴합니다.

7. 전달 및 정리

  • 전달. 비디오를 $P/<slug>.mp4로 복사하고 open하세요. 이전 버전이 있으면 덮어쓰지 말고 이름을 바꿔 보관하세요(예: old-<voice>-<slug>.mp4).
  • 보고. 길이, 해상도, 챕터, 음성, 녹화 위치, 표시된 모든 단순화, 확인할 수 없었던 사항(오디오), 남은 시각적 결함을 알려주세요.
  • 정리 전에 물어보세요. 일회용 복사본이나 환경을 제거하기 전, takes/를 삭제하기 전(프레임은 GB를 차지함) 사용자의 승인을 받으세요. 나중에 재녹화할 수 있도록 script.cjs, 설정 및 audio/는 보관하세요.
  • 기록하세요. 작업이 티켓이나 노트 파일에 속하는 경우, 비디오 위치와 복사본 삭제가 보류 중임을 거기에 기록하세요. 해당 파일만 커밋하세요.

관련 스킬