Communitygithub.com

dsonders/claude-skills

실제 TenthGear 앱을 보여주는 나레이션이 포함된 교육 또는 워크스루 비디오(및 일치하는 주석이 달린 슬라이드와 PDF)를 제작합니다. Dave가 제자리에서 편집하는 디자인 캔버스의 스토리보드(주요 프레임, 콜아웃, 음성 트랙)로 시작한 다음, 라이브 앱에서 스틸 이미지와 영상을 캡처하고, OpenAI 텍스트 음성 변환으로 나레이션을 추가하며, 비디오를 조립합니다. 교육 비디오, 시작 가이드, 빠른 시작, 방법 비디오, 워크스루, 기술자 또는 어드바이저를 위한 주석이 달린 스크린샷을 요청하거나 기존 교육 비디오를 수정할 때 사용하세요.

claude-skills란 무엇인가요?

이 스킬은 Dave가 스토리보드 디자인 캔버스에서 스크립트와 콜아웃을 편집한 후 실제 TenthGear 앱에서 스틸 이미지와 비디오 클립을 캡처하여 교육용 비디오를 제작하는 워크플로우를 자동화합니다. 주요 원칙은 '프로덕션 전에 스토리보드 먼저'이며, Dave가 편집을 완료할 때까지 아무것도 녹음하거나 조립하지 않고 실제 앱 화면만 사용해야 합니다. 이 스킬은 모든 교육 자료(비디오, 슬라이드, PDF)를 하나의 `storyboard.json` 파일로 관리하며, 스토리보드 편집, 스틸 이미지 및 영상 캡처, OpenAI TTS 나레이션 생성, 최종 비디오 조립을 포함한 10단계 워크플로우를 제공합니다. Claude Code 에이전트 환경에서 실행되며, 디자인 캔버스 도구, 앱 캡처 유틸리티, 스크립트를 사용하여 일관된 교육 콘텐츠를 생성합니다.

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

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

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

문서

비디오 교육: 먼저 스토리보드, 그 다음 실제 앱 화면

여기서 교육 비디오는 일련의 전화기 모양 카드 세트입니다. 각 카드에는 제목, 한 줄의 도움말, 실제 앱의 주요 프레임(콜아웃 포함), 그리고 한 줄의 나레이션이 있습니다. 일부 카드는 스틸 이미지 대신 앱의 짧은 클립을 재생합니다. 동일한 카드가 슬라이드와 PDF로도 제공됩니다.

모든 것을 제어하는 하나의 파일(storyboard.json)이 있습니다. Dave는 디자인 캔버스를 통해 이 파일을 편집합니다. 모든 빌드 스크립트는 이 파일을 읽습니다.

사용 시기

다음과 같은 경우에 사용하세요:

  • 앱을 보여주는 교육, 시작, 빠른 시작 또는 방법 비디오
  • 기술자, 어드바이저 또는 부서 직원을 위한 주석이 달린 스크린샷 또는 슬라이드 가이드
  • 이 스킬로 만든 비디오의 수정(새로운 문구, 새 카드, 새 클립)

다음과 같은 경우에는 사용하지 마세요:

  • 마케팅 또는 프로모션 비디오(분위기와 규칙이 다름, Dave에게 문의)
  • 제품 내부에서 녹화된 고객 검사 비디오
  • 아직 존재하지 않는 화면의 목업(/visual 사용)

원칙

  1. 프로덕션 전에 스토리보드 먼저. Dave가 스토리보드 캔버스를 편집하고 완료했다고 말할 때까지 아무것도 나레이션하거나 조립하지 않습니다.
  2. 실제 앱으로 실제 작업을 보여주세요. 실제 스캔, 실제 받아쓰기, 실제 생성된 스토리. 가짜 화면이나 입력된 결과를 사용하지 마십시오.
  3. Dave는 캔버스에서 규칙을 정하고 채팅에서 하지 않습니다. 캔버스를 다시 읽고 차이점을 비교하세요. 대화에서 그의 방향을 재구성하지 마십시오.
  4. 승인된 테이크는 유지됩니다. 단어가 변경된 라인에 대해서만 나레이션이 다시 생성됩니다. Dave가 검토한 버전을 덮어쓰지 말고 -v2, -v3를 제공하세요.
  5. Claude는 듣거나 볼 수 없습니다. 모든 인계 시 이 점을 언급하세요. 전사(transcription)를 통해 단어를 증명하고 샘플 프레임을 통해 그림을 증명하며, 확인되지 않은 사항을 명시하세요.
  6. 스토어를 발견한 그대로 두세요. 모드가 복원되고 확인되었으며, 재촬영 수리 주문이 종료되었습니다.

먼저 읽기

  • /Users/davidsonders/ro-bot/shared/product-facts.md 및 shared/brand.md: 이름, 개수, 금지어. 대시(em dash)나 이모지 사용 금지, "TenthGear"는 한 단어로 표기. 시청자가 보거나 듣는 모든 것에서 "싱글 플레이어" 또는 "멀티 플레이어"라고 말하지 마십시오.
  • 이 폴더의 reference.md: 기술적 함정(각각 한 번씩 이미 비용을 지불한 것들).
  • 디자인 캔버스에 대한 메모리 노트: reference_design_canvas_mechanics, reference_design_canvas_roundtrip, reference_design_canvas_entity_crash.

파일 위치

항목위치
비디오 프로젝트 폴더/Users/davidsonders/ro-bot/training-videos/<slug>/ (세션과 함께 사라지는 세션 스크래치패드는 사용 금지)
유일한 진실 공급원<project>/storyboard.json
키 프레임, 클립, 나레이션<project>/frames/, footage/, narration/
빌드 결과물<project>/out/
Dave가 받는 위치~/Desktop/<Title>/
작업 예시training-videos/story-writer-getting-started/ 및 여기의 examples/story-writer/

스크립트는 여기의 scripts/에 있습니다. 첫 번째 인자로 프로젝트 폴더를 받습니다.

워크플로우

이 단계에 대한 할 일 목록을 만들고 순서대로 진행하세요.

0단계: 브리핑 확정

요청에서 다음 사항을 찾으세요. 누락된 항목에 대해서만 질문하고, 권장 사항을 먼저 제시하세요.

결정 사항기본값
시청자와 역할기술자
전화기 또는 데스크톱전화기, 390 x 844
어떤 플로우, 처음부터 끝까지Dave의 개요
스토어 및 워크플로우 모드Dave에게 문의. 2단계 참조.
스틸 이미지만 또는 스틸 이미지와 클립화면이 움직이는 곳마다 클립: 녹화, 로딩, 열기 및 닫기
길이2분 30초 미만

1단계: 디자인 캔버스에 스토리보드 작성

이것이 Dave가 가장 먼저 보게 되는 것이며, 그가 스크립트와 콜아웃을 편집하는 곳입니다.

  1. 프로젝트 폴더를 생성하고 필요한 소품을 렌더링합니다(props/render-paper.mjs가 샘플 종이 수리 주문서를 만듭니다).

  2. 키 프레임을 위해 플로우를 스카우트합니다. 키 프레임은 실제 앱에서 가져오므로 이 단계에는 캡처 실행(2단계 및 3단계, 스틸 이미지만)이 필요합니다. examples/story-writer/capture-stills.mjs를 프로젝트에 복사하고 플로우를 다시 작성하세요. 진행하기 전에 모든 프레임을 살펴보세요.

  3. storyboard.json을 초안으로 작성합니다. 시청자가 수행하는 작업당 하나의 카드입니다. 형식:

    { "id": "write-story", "part": 2, "img": "10-write-story",
      "title": "[[스토리 작성]] 탭",
      "body": "AI 작성기가 귀하의 메모를 검토하고 3C를 자동으로 생성합니다.",
      "boxes": [[183, 400, 191, 44]], "arrow": [162, 768],
      "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "클립이 보여주는 내용" },
      "narration": "준비가 되면 스토리 작성을 탭하세요." }
    

    boxes와 arrow는 전화기 픽셀 단위입니다. 캡처는 각 컨트롤의 박스를 프레임 옆에 기록합니다. [[레이블]]은 버튼 칩을 그립니다. 첫 번째 초안부터 아래 스타일 규칙을 따르세요.

  4. 캔버스를 생성합니다. 아티팩트 도구: intent가 design인 quickstart를 사용한 다음, 반환된 type_url과 제목으로 게시합니다. url을 <project>/storyboard/artifact.json에 저장합니다.

  5. 키 프레임을 캔버스에 업로드합니다 (JPEG, 1688px 높이, 한 번의 호출로 업로드되도록 스크래치패드에 준비). 반환된 각 /_blob/... url을 프레임 이름을 키로 하여 artifact.json의 assets 아래에 기록합니다.

  6. 생성 및 게시합니다. node scripts/storyboard-canvas.mjs <project>가 storyboard/project/를 작성합니다. 해당 폴더를 스크래치패드에 복사하고 게시합니다: canvas.json은 file_path로, 모든 .dc.html은 files로.

  7. Dave에게 링크를 전달하고 중단합니다. 그에게 알리세요: 카드의 단어를 다시 입력하고, 각 카드 아래의 파란색 메모는 음성 트랙이며, 노란색 콜아웃을 드래그하고, 메모에 다른 내용을 작성하세요. 프로덕션을 시작하지 마십시오.

  8. 그의 편집 내용을 수집합니다. paths(인덱스 및 모든 아트보드)와 out_dir로 아티팩트 read를 실행한 다음, node scripts/storyboard-harvest.mjs <project> <out_dir>을 실행합니다. 보고서를 평문으로 그에게 읽어주고, 그가 추가한 메모에 대해 조치를 취한 다음 --write로 다시 실행합니다.

  9. 또 다른 라운드가 필요합니까? project/canvas.json을 다시 읽고, --live <that file>로 다시 생성한 다음 다시 게시합니다. 라이브 인덱스에서 시작하지 않는 게시는 거부됩니다.

2단계: 스토어 빌리기

앱은 비디오가 보여주는 모드에 있어야 합니다. 테스트 스토어만 사용할 수 있습니다.

스토어ID일반 모드참고
Summit Auto Group (데모)demo-dealership팀 워크플로우Dave의 잠재 고객 데모. 로그인 [email protected] (기술자), marcus@ (어드바이저), priya@ (부서). 첫 번째 비디오에 사용됨.
테스트 딜러십 1mlTaPo12wbpUtJB9GXJM팀 워크플로우빌드 세션과 공유됨. 자주 사용 중.
  1. ListAgents를 실행한 다음 각 피어에게 SendMessage로 메시지를 보내세요: 스토어를 사용 중인지, 모드가 필요한지 확인합니다. 답변을 기다리세요. 피어가 필요로 하는 경우 다른 스토어를 사용하거나 Dave에게 문의하세요.
  2. 먼저 모드를 읽습니다: 앱 폴더에서 NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id> 실행.
  3. 캡처가 실행되는 몇 분 동안만 변경하고, 캡처 명령 체인과 복원 명령 체인에서 함께 실행합니다. 그런 다음 모드를 다시 읽고 확인합니다.
  4. 고객 스토어는 절대 건드리지 마세요. 테스트 계정의 환경설정을 변경하지 마세요.

3단계: 캡처

  • 스틸 이미지: dpr: 3. 카드당 한 프레임, 화면이 안정된 후에 촬영합니다.
  • 클립: dpr: 2와 vt.recorder 사용. 각 클립은 정적인 상태의 비트로 시작하고, 손가락 마커를 표시한 다음, 작업을 수행합니다. marks.json을 읽어 footage.runs를 선택하세요.
  • 받아쓰기는 실제여야 합니다. vt.dictation은 음성 클립을 가짜 마이크로 재생합니다. 앱이 이를 기록하고 전사합니다. 모든 전사본을 출력하고 읽으세요: 전사기는 숫자와 브랜드 이름을 다시 씁니다.
  • 재촬영에는 새로운 수리 주문이 필요합니다. 위쪽으로 번호를 매기고 각 id를 created-ros.txt에 나열하세요.

4단계: 슬라이드

node scripts/build-slides.mjs <project>는 out/slides/*.png, PDF, 그리고 비디오에 필요한 레이어를 생성합니다. 모든 카드의 연락처 시트(contact sheet)를 확인하세요. 콜아웃이 가리키는 대상을 덮고 있지 않은지 확인하세요.

5단계: 나레이션

cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>

음성 ash, 모델 gpt-audio-1.5 (gpt-4o-mini-tts에서 이동, OpenAI가 2027-01-06에 종료 예정). 전사가 카드의 단어와 일치하지 않는 테이크는 재시도된 후 거부됩니다. Dave는 이 음성을 승인했으며 Mac의 내장 음성을 로봇 같다고 거부했습니다. 앱의 OpenAI 키를 사용하며 빌드당 몇 센트의 비용이 듭니다: 새 비디오에 대한 브리핑에 이 내용을 포함하여 비용이 예상치 못한 일이 발생하지 않도록 하세요. DRY=1은 재생성될 항목을 나열합니다.

귀를 위한 나레이션을 작성하세요: "R O", "three Cs", "tenthgear dot A I". 각 부분이 포함된 첫 번째 카드에서 해당 부분을 알리세요.

6단계: 비디오

node scripts/build-video.mjs <project>. 속도는 1.25(QuickTime의 "빠르게")이며, Dave가 승인한 속도입니다. 클립이 있는 카드는 나레이션과 클립 중 더 긴 시간 동안 재생됩니다.

7단계: 확인 및 미확인 사항 명시

  1. check-audio.mjs는 비디오를 전사하고 각 카드의 점수를 매깁니다. 모든 LOOK 라인을 읽으세요.
  2. 클립이나 화살표가 있는 각 카드에서 한 프레임을 가져와서 확인하세요.
  3. 인계 시에 명확히 밝히세요: 끝까지 듣지 않았고, 끝까지 보지 않았습니다.

8단계: 전달

비디오, PDF 및 out/slides/를 ~/Desktop/<Title>/에 복사하세요. 이전 버전은 유지하세요. 길이, 변경된 사항, Dave가 알아차릴 수 있는 모든 것(클립의 다른 수리 주문 번호, 영상 위에 떨어진 콜아웃 등)을 알려주세요.

9단계: 정리

  • 스토어 모드가 복원된 후 다시 읽고 확인합니다.
  • node scripts/close-ros.mjs <project> <email> <org-id>는 재촬영을 종료합니다. 수리 주문 삭제는 Dave의 결정에 따릅니다.
  • 메시지를 보낸 모든 피어에게 스토어가 사용 가능하다고 알리세요.

스타일 규칙 (Dave, 2026-09-29)

규칙예시
시청자가 탭하는 버튼은 버튼처럼 그려짐[[새 RO]] 탭
파트 헤더는 "3부 중" 없이 짧게파트 2: 보증 스토리
커버에는 단계 수가 없음
단계당 하나의 카드. 하나의 결정을 보여주는 카드는 병합검토 및 저장은 하나의 카드
자명한 포인트의 카드는 삭제원인 및 수정 사항 읽기
누가 어떤 동작을 하는지 명시"메모 추가"가 아닌 "음성 메모 추가"
화면에서 두 가지가 의미될 수 있는 경우, 하나를 가리킴녹색 버튼에 화살표
앱에서 움직이는 모든 것은 비디오에서도 움직여야 함파형, 스피너, 카드 열림
현장 용어RO, 라인, 스토리, 3Cs, CP

Dave는 PDF 페이지 번호로 슬라이드 편집 내용을 제공합니다. 1페이지는 커버이므로 "pg 7"은 6단계입니다. 적용하기 전에 각 편집 내용을 단계 이름으로 다시 설명하세요.

성공 기준

  • Dave가 스토리보드 캔버스를 편집했으며 그의 편집 내용이 추측이 아닌 수집된 것임
  • 모든 프레임과 클립이 비디오가 다루는 모드의 실제 앱임
  • 슬라이드, PDF 및 비디오가 모두 동일한 storyboard.json에서 생성됨
  • 나레이션이 전사를 통해 확인되었으며, 불명확한 라인이 명명됨
  • 인계 시 듣거나 보지 않은 부분이 명시됨
  • 스토어 모드가 복원 및 확인되었으며, 재촬영 수리 주문이 종료됨
  • 프로젝트 폴더가 스크래치패드 외부에 유지됨

관련 스킬

  • /visual: 아직 존재하지 않는 화면의 목업용
  • /app-testing: 빌려오는 테스트 계정 및 라이브 패스 harness용
  • /compound: 캡처 과정에서 제품 버그 또는 새로운 함정이 발견된 경우 그 이후에 사용

관련 스킬