Communitygithub.com

JacobLinCool/video-studio-mlx

모든 앱이나 웹사이트에 대해 전문적인 나레이션이 포함된 데모/프로모션 비디오를 제작합니다. 실제 화면 녹화 영상과 video-studio-mlx Studio API를 통해 생성 및 ASR 검증된 나레이션을 결합합니다.

video-studio-mlx란 무엇인가요?

이 스킬은 어떤 macOS 앱, 웹사이트, CLI 등 사용자가 지정한 모든 제품에 대해 약 90~180초 길이의 나레이션 데모 비디오를 제작하는 파이프라인을 제공합니다. 나레이션은 video-studio-mlx Studio API의 `/studio/tts` 엔드포인트를 통해 생성되며, 음성 복제 및 각 단어별 타임스탬프를 제공하여 정확한 동기화를 가능하게 합니다. 전체 워크플로우는 나레이션 중심(narration-first) 방식으로, 대본을 먼저 작성하고 TTS로 나레이션을 생성한 후, AppleScript(맥 앱) 또는 Playwright(웹)를 이용해 대상 화면을 녹화하고, ffmpeg로 합성하여 완성된 비디오를 만듭니다. 특히 구성 단계에서는 프레임이 있는 무대, Pillow 자막, 영웅 샷 줌, 나레이션 시간에 맞춘 포커스 줌 및 링 효과, 장면 간 크로스페이드 등을 지원합니다. 사용자는 데모 비디오, 나레이션이 포함된 둘러보기/홍보 영상, 또는 음성과 화면이 동기화된 비디오가 필요할 때 이 스킬을 사용할 수 있습니다. 단, 나레이션이 없는 단순 화면 녹화나 스크린샷에는 적합하지 않습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/JacobLinCool/video-studio-mlx/tree/HEAD/.agents/skills/studio-demo-video

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

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

문서

Studio 데모 비디오

사용자가 이름을 지정한 어떤 제품(macOS 앱, 웹사이트, CLI 등 화면 녹화가 가능한 모든 것)에 대한 약 90~180초 분량의 나레이션 데모를 제작합니다. 유일하게 고정된 부분은 나레이션 백엔드, 즉 video-studio-mlx Studio API(POST /studio/tts)이며, 이 API가 음성을 복제하고 각 문장을 검증합니다. 데모의 대상은 임의적이며 매번 바뀝니다. 이 분리를 명심하세요. 데모 대상이 video-studio-mlx 자체라고 가정하지 마세요(그것은 단지 references/에 있는 예시일 뿐입니다).

핵심 원칙: 나레이션 우선, 정확한 길이 고정

어떤 영상보다 먼저 나레이션을 생성하세요. /studio/tts는 각 세그먼트의 정확한 길이 및 단어별 타임스탬프를 반환합니다. 이 정보가 전체 타임라인과 모든 포커스 효과를 결정합니다. 그런 다음 영상을 넉넉히 녹화하고 각 클립을 해당 세그먼트에 맞춥니다. 먼저 영상을 자르고 나중에 음성을 입히면 재조정이 까다로워집니다.

일반적으로 출력물을 재생하거나 들을 수 없습니다. 이것을 엄격한 제약 조건으로 취급하세요. 프레임을 추출하여 비디오를 검증하고, 완성된 파일의 일부 구간에 ASR을 실행하여 오디오 내용과 동기화를 확인하세요. 이런 방식으로 확인할 수 있도록 모든 것을 구축하세요.

파이프라인

  1. 장면별 스토리보드를 작성합니다 — 나레이션 텍스트, 화면 동작, 캡션, 그리고 (장면별로) 포커스가 가리킬 요소를 나레이션이 명명하는 부분을 포함합니다. 속도는 약 2.1단어/초를 목표로 합니다(≈170단어 ≈ 80초). references/storyboard.example.json을 <work>/storyboard.json으로 복사하세요. 각 명명된 요소가 해당 장면의 영상에서 실제로 보이고 순서대로 나타나도록 나레이션을 작성하세요. 듣는 사람을 위해 작성하세요. 단어를 쓰여진 대로가 아니라 말해지는 대로 철자하세요. 약어와 두문자어는 풀어쓰고(

관련 스킬