Communitygithub.com

paxon-yang/talking-video-skills

한 줄 요구사항 → 구술/모션 설명 영상 완성본 (자막 동기화, 디지털 아웃페인트 합성, AE급 모션, 타자기 효과 및 사운드, 썸네일 및 한 줄 카피 제공). 사용자가 'X에 대한 영상을 만들어 줘', '구술 영상 만들어 줘', 'X에 대한 모션 영상 만들어 줘', '이 대본을 완성본으로 만들어 줘'라고 말할 때 사용합니다. 이 스킬은 총 진입점입니다: 기본값을 자체 결정하고 전체 워크플로우를 자동으로 진행하며, '사람만 할 수 있는' 단계에서만 멈춥니다. 세부사항은 각각 combo-style(구술 포장 및 협업)과 ae-motion-craft(모션 규칙 및 방법)를 참조하세요.

talking-video-skills란 무엇인가요?

이 스킬은 사용자의 간단한 요청을 기반으로 전문가 수준의 구술 영상 또는 모션 설명 영상을 자동으로 제작하는 AI 에이전트 기능입니다. 사용자가 주제, 구술 여부, 음성 출처만 알려주면, Claude가 나머지 모든 과정—대본 작성, 더빙 동기화, 자막 정렬, 디지털 아웃페인트 합성(선택 사항), 모션 그래픽, 타자기 효과, 사운드 디자인, 렌더링, 자체 검사, 썸네일 및 카피 생성—을 자동으로 처리합니다. '사람만 할 수 있는' 작업(예: 실제 더빙 녹음, 디지털 아웃페인트 결제, 최종 심미적 승인)에서만 사용자에게 명확히 요청하고, 나머지는 모두 Claude가 자율적으로 진행합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트 환경에서 사용하도록 설계되었으며, ffmpeg, whisper, 이미지 생성 도구 등의 명령줄 도구를 활용합니다. 사용자는 최소한의 개입만으로 고품질의 완성된 동영상을 받을 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/paxon-yang/talking-video-skills/tree/HEAD/skills/talking-video-oneshot

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

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

문서

한 줄 완성본: 총 진입점

목표: 사용자는 요구사항만 말하고, Claude가 대본, 자막, 모션, 사운드, 렌더링, 자체 검사, 썸네일, 카피를 모두 처리하여 완성본을 제공합니다. 매 단계마다 묻지 말고, 사용자가 스스로 결정할 수 있는 일에 대해 확인을 요구하지 마세요.

사전 준비물 확인 (작업 시작 전 30초)

../video-asset-prep/SKILL.md의 준비물 목록 확인: 디지털 아웃페인트(출연 버전에만 필요), 음성, 모듈 라이브러리, 고정 프레임워크. 누락된 항목이 있으면 해당 항목을 준비하고, 억지로 진행하지 마세요; 순수 모션 버전에는 디지털 아웃페인트가 필요하지 않습니다. 준비물이 모두 완료되면 아래 모든 과정을 자동으로 진행합니다.

0. 요구사항 수집 (최대 한 번, 세 가지 질문을 묶어서)

완성본 구조를 바꾸거나 기본값으로 결정할 수 없는 것만 질문합니다. 사용자가 답하지 않은 모든 항목은 기본값을 따릅니다:

질문기본값
주제 및 관점 (한 줄, 또는 초안)필수
디지털 아웃페인트 출연 여부?없음 (순수 모션). 있으면 사용자의 디지털 아웃페인트 이미지와 더빙 필요
더빙 출처는?사용자 자신의 클론 음성으로 오디오를 생성하여 전송; 없으면 시스템 TTS로 자리 표시 후 전체 프로세스 진행, 실제 더빙이 도착하면 정렬만 다시 실행

고정 기본값: 1920×1080, 30fps, 60–80초, BGM 없음(음성 + 사운드 이펙트만, 음악은 사용자가 직접 추가), 자막 캡슐, 밝은색 또는 어두운색은 주제에 따라 결정, 완성본 −16 LUFS, 썸네일 가로/세로 각 한 쌍, 한 줄 카피.

1. 파이프라인 (자동 진행)

단계작업담당산출물 / 검수
S1 대본8–12문장 구술로 압축: 각 문장 ≤20자, 한 문장에 한 가지 의미, 숫자는 별도 문장으로; AI 어투 제거(짧은 문장, 구어체, 대구 최소화); 사실 확인; 글자 수 ≈ 시간×4.8Claudescript_lines.json; 사실에 의문이 있을 때만 사용자에게 문의
S2 더빙대본을 더빙 도구 읽기 방식으로 수정(약어는 A I처럼 한 글자씩 발음) → 사용자가 오디오 생성 → 로컬에서 절전 간격 0.4초 이내사용자가 오디오 제공voice.mp3; 이것이 유일하게 사람을 기다려야 하는 단계 (없으면 자리 표시)
S3 정렬whisper 강제 정렬 → 단어 단위 자막 → 파형과 독립적으로 시작음 확인Claudewords.json subs.json; 자막 시작 시간 ≤3프레임
S4 디지털 아웃페인트 (선택 사항)브라우저로 디지털 아웃페인트 도구 실행: 오디오 업로드 → 생성 → 다운로드. 신원 확인, 결제, 삭제는 사용자만 수행Claude + 사용자그린 스크린 mp4
S5 크로마키 (선택 사항)색차 키 + 가장자리 확장 → VP9 알파 WebM; 디코딩 곡선 보정; 입 모양 3프레임 앞당김Claudekey_host.py
S6 장면표모든 장면 시간을 단어 정렬표에서 유도 (문장 시작 −6프레임을 절단점으로), 프레임 번호 수동 입력 금지Claudetimeline.ts 단일 진실 공급원
S7 모션각 문장에 한 장면, 한 카메라, 한 초점; 모든 타자기는 타자기 모션 사용 및 typing.ts에 등록; 사운드 이펙트는 이벤트에 따라 생성Claudeae-motion-craft 참조
S8 렌더링분할 + 감시: 5분 동안 새 프레임 없으면 프로세스 종료 후 최대 3회 재시도; 각 구간 시작/종료 시간 로그 기록Claude분할 mp4 → 병합 → 믹싱
S9 자체 검사섹션 3 체크리스트 참조; 실제 파일 타임스탬프와 로그를 확인하고, 감에 의존하지 말 것Claude자체 검사표
S10 포장가로 + 세로 썸네일 (메인 이미지 + 대안), 썸네일 크기 확인, 한 줄 센스 있는 카피Claude썸네일 4장 + 카피

2. 사람만 할 수 있는 작업 (나머지는 모두 자체 처리)

더빙 오디오 생성, 디지털 아웃페인트 신원 확인, 결제 확인, 계정/이미지 삭제, 최종 심미적 승인. 이러한 작업이 발생하면 무엇이 필요한지 한 번에 명확히 말하고, 여러 번에 나누어 질문하지 마세요.

3. 자체 검사 체크리스트 (전달 전 항목별로 ✓/✗/값 기록)

  • 길이: 비디오와 오디오 차이 ≤0.05초; ffprobe 1920×1080 / 30fps / BT.709
  • 음량 −16 LUFS (음성 + 사운드 이펙트), 피크 < −1 dBFS; 사운드 이펙트는 음성보다 ≥10 dB 낮음
  • 자막: 각 줄 시작 시간과 파형 편차 ≤3프레임, 시간 중복 없음, 하나의 스타일
  • 보라색 픽셀 비율 (보라색 선을 원하지 않는 경우) <0.2%; 2프레임 스트립 절단점에 하드 점프 없음
  • 각 타자기 블록: 문자 수 = 키 사운드 수
  • 화면에 제3자 브랜드/실제 인물/내부 파일 이름 없음; 중국어 비디오 화면 텍스트는 일반 용어 사용
  • 렌더링 산출물 타임스탬프가 마지막 수정 시간보다 늦음; 로그에 실패한 세그먼트 없음

4. 철칙 (겪었던 실수)

  1. 원인을 추측하지 마세요: 렌더링이 멈추면 먼저 파일 수정 시간과 현재 시간을 비교하고, 전체 로그를 읽은 후 결론 내리세요.
  2. 사용자를 감독관으로 만들지 마세요: 긴 작업은 각 구간마다 타임스탬프를 기록하고, 멈추면 스스로 발견하여 재시도하세요.
  3. 정지 프레임/저해상도 프리뷰로 먼저 자체 확인한 후, 1080p로 렌더링하세요.
  4. 자막은 반드시 단어 단위로 정렬해야 하며, 글자 수를 기준으로 추정하지 마세요.
  5. BGM을 넣지 마세요; 설명용 작은 텍스트를 넣지 마세요; 밝은 배경에 큰 어두운 블록을 넣지 마세요; 보라색을 사용하지 마세요.
  6. 사용자의 구체적인 피드백이 있으면 영향을 받은 장면만 다시 작업하고, 전체 영상을 처음부터 다시 만들지 마세요.
  7. 전달 후에는 과정을 반복해서 보고하지 말고, 다음만 제공하세요: 위치, 수정한 내용, 알려진 결함, 썸네일, 한 줄 카피.

5. 관련

  • 사전 준비물 (디지털 아웃페인트/음성/모듈/고정 프레임워크): ../video-asset-prep/SKILL.md
  • 이 스킬의 세부 사항은 references/에 있습니다: 대본 및 후크(hooks-and-copy, thinking, templates), 스토리보드 및 화면(visual-mapping, motion-and-camera, packaging), 자막 정렬(subtitle-sync), 편안함 규칙(comfort-rules), 전체 프로세스 매뉴얼(production-playbook), 구술 영상 합성(hosted-video-fusion), 렌더링 및 파이프라인(remotion-pipeline, promo-and-hosted-pipeline), 사운드 이펙트(motion-polish-and-sfx), 협업(collaboration), 중문/영문 버전(english), 썸네일素材(gemini-asset-prompts).
  • references/legacy-combo-style-SKILL.md는 분할 전의 예전 개요이며, 참고용으로만 사용하세요. 파일 경로는 현재 디렉토리를 기준으로 합니다.
  • 스크립트: scripts/, ../../pipeline-scripts/; 전체 방법론: ../../方法论-制作篇.md

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

paxon-yang/talking-video-skills

用户提供自己的数字人视频(或先拿 Claude 写的口播稿去数字人工具生成),和 Claude 多轮沟通、逐轮打磨,按 combo 风格(博主A × 博主B 合并后的"暗底固定框架 + 数字人口播 + 少而准的动效")做出 1–3 分钟横屏精品讲解视频,目标是成片和原片一样精美。用户说"按 combo 风格/博主A风格/博主B 风格做视频""我有数字人视频,帮我包装/加动效""帮我写数字人口播稿/脚本""出分镜表""给剪映剪辑说明""做 Remotion 动效视频/写 timeline.json/出样张/预览/渲染""这条视频不够精致,再改改"时使用。流程是协作轮次:素材接收 → 稿子 → 分镜 → 关键帧样张(与原片并排) → 低清预览 → 精修终版;每轮交给用户看、请用户确认、按反馈修改,可随时回到前面任一轮。

paxon-yang/talking-video-skills

做口播 / 动效视频之前的备料:数字人(形象、绿幕生成、抠像、清晰度、口型校准)、克隆声音(读音规则、停顿处理)、沉淀动效积木(拆解参考视频→提取带数值的规律→做成带参数的组件→逐镜头复刻验证)、固定框架(字幕胶囊、背景、封面)。用户说「准备数字人」「学这个动效」「拆一下这个视频的动效」「沉淀成积木」「做我自己的动效库」「备料」「我还缺什么才能开始做视频」时使用。备齐后用 talking-video-oneshot 做片。

관련 스킬