cclank/lanshu-create-ai-presenter-video

Provider-neutral Codex Skill for producing verified AI presenter videos from a script and an authorized presenter image.

lanshu-create-ai-presenter-video

개요 – 코딩 어시스턴트(Claude, Codex, Cursor 등)가 짧은 주제나 스크립트에서 완전한 설명 동영상을 생성할 수 있게 해주는 Agent Skill입니다. 이 스킬은 두 가지 경로를 따를 수 있습니다:

경로	결과	제공할 것
프레젠터	디지털 휴먼이 카메라에 등장하며, 라이브 캡션과 키워드 그래픽 포함	주제 또는 스크립트 + 소유한 초상화 이미지(선택 사항: 음성 샘플)
스타일 설명	12개의 사전 구축된 시각적/내러티브 스타일 중 하나를 사용한 애니메이션 스타일 동영상(프레젠터 없음)	주제 또는 스크립트(또는 자체 내레이션)

에이전트는 저장소의 스크립트를 실행하고, 작업 폴더를 만들고, 각 단계로 진행하기 전에 디스크에 증거를 기록하는 게이트 워크플로우를 단계별로 진행합니다. 모든 공급자 호출(음성 합성, 프레젠터 비디오, 립싱크, 음성 인식 등)은 모델/매개변수 ID와 함께 기록되며, 비용 가드레일로 유료 요청 전에 청구 내역이 표시되도록 보장합니다.

주요 하이라이트

하네스 및 공급자 중립적 – 모든 Agent-Skills 클라이언트 및 명령줄에서 호출할 수 있는 모든 클라우드 또는 로컬 모델과 작동합니다.
12가지 기성 설명 스타일 – 9가지 시각적(에디토리얼, HUD, 노트북, 팝업, 만화, 3D 원테이크, 드래프팅 시트, 칠판, 클레이 타운) 및 3가지 내러티브(유도, 사건 파일, 시트콤) 키트가 있으며, 각각 시작 자산이 포함됩니다.
오디오 잠금 타임라인 – 최종 내레이션이 마스터 클록이며, 캡션, 프레젠터 동작, 컷, 그래픽이 모두 이에 맞춰집니다.
증거 게이트 파이프라인 – 8가지 제작 상태(intake → verified)가 아티팩트 존재로부터 자동으로 계산되어 우발적 진행을 방지합니다.
비용 안전 – 파일럿 우선 생성, 명시적 청구 미리보기, 재시도 상한, 작업 ID 재사용으로 중복 청구 방지.
검증된 전달 – 마스터 및 공유 인코딩은 어떤 파일이 게시되기 전에 디코딩 및 음량 확인됩니다.

작동 방식(높은 수준)

초기화 – init_job.py가 자체 포함 작업 디렉토리를 만들고 입력을 기록합니다.
사전 점검 – preflight.py가 스크립트, 초상권 및 기타 승인을 검증합니다.
내레이션 – 음성 트랙을 생성하거나 수락합니다. 단어 수준 타임스탬프가 캡처됩니다(스타일 경로는 MiniMax 사용).
프레젠터 생성(프레젠터 경로) – 비디오 생성 서비스를 호출하여 디지털 휴먼 클립을 만든 다음 내레이션에 립싱크합니다.
오디오 기반 편집 – 캡션, 키워드 그래픽, 오프닝/클로징 샷을 내레이션 타임라인에 배치합니다.
품질 검사 – qa.py / check_state.py가 디코딩 가능성, 음량(-16 LUFS ±0.5) 및 시각적 일관성을 검증합니다.
렌더링 및 전달 – finalize_delivery.sh가 마스터 및 공유 사본, 콘택트 시트, 전달 보고서를 생성합니다.

스타일 경로는 유사한 흐름을 따르지만 프레젠터 생성을 건너뜁니다. 대신 스크립트의 각 줄이 선택한 스타일 키트를 사용하여 짧은 애니메이션 장면으로 변환됩니다.

요구 사항

Agent-Skills 하네스(또는 파일을 읽고 셸 명령을 실행할 수 있는 모든 에이전트)
Python 3.9+, FFmpeg(ffprobe 포함), Bash, jq, awk, sed
프레젠터 경로 – 음성 합성 API, 프레젠터 비디오 생성 API, 립싱크 도구(클라우드 CLI, API 또는 로컬 모델)에 대한 액세스. 선택 사항: 캡션/그래픽 합성을 위한 HyperFrames.
스타일 경로 – Node.js(HyperFrames용), rsync, Python numpy, 음성 타임스탬프용 MiniMax API 키(또는 자체 녹음 내레이션).

설치 및 빠른 시작

# 하네스의 스킬 디렉토리에 클론(예: Claude Code)
git clone https://github.com/cclank/lanshu-create-ai-presenter-video.git \
  ~/.claude/skills/lanshu-create-ai-presenter-video

클론 후 하네스가 자동으로 스킬을 선택하도록 동영상을 설명하거나(예:), 또는 명시적으로 호출할 수 있습니다.

이 스크립트와 초상화를 라이브 캡션이 있는 30초 9:16 프레젠터 비디오로 변환해 주세요.

또는 명시적으로 호출합니다:

SKILL_DIR=~/.claude/skills/lanshu-create-ai-presenter-video
python3 "$SKILL_DIR/scripts/init_job.py" \
  --job-dir ~/Videos/my-presenter \
  --presenter-image ~/Pictures/presenter.png \
  --topic "Context engineering in one minute" \
  --duration 60 \
  --aspect 9:16 \
  --rights-confirmed \
  --adult-presenter-confirmed
python3 "$SKILL_DIR/scripts/preflight.py" ~/Videos/my-presenter/job.json
python3 "$SKILL_DIR/scripts/check_state.py" ~/Videos/my-presenter/job.json --write

스타일 설명 동영상의 경우 --route styled를 지정하고 스타일(예: v8-chalkboard)을 선택합니다. 저장소에는 에이전트가 자동으로 실행하는 헬퍼 스크립트(story.py, new_film.sh, qa.py, render.sh)가 포함되어 있습니다.

테스트

두 개의 스모크 테스트 스크립트가 제공됩니다:

bash tests/smoke.sh               # 프레젠터 파이프라인(원격 호출 없음)
bash tests/explainer_smoke.sh     # 스타일 파이프라인(Node.js 필요)

CI는 모든 푸시에서 이를 실행합니다.

라이선스

MIT – 자유롭게 사용, 수정, 재배포할 수 있습니다.

결론 – lanshu-create-ai-presenter-video는 LLM 기반 코딩 에이전트가 간단한 아이디어를 완성도 높은 설명 동영상으로 변환할 수 있게 해주는 바로 플러그인 가능한 스킬입니다. 워크플로우에는 강력한 안전, 비용 및 품질 제어가 내장되어 있습니다.