feitangyuan/onetake

onetake – 원테이크 연속 모션 비디오 스킬

그것이 무엇인가

• Claude(또는 다른 LLM) 에이전트 스킬로, AI에게 단일, 컷 없는 테이크로 짧은 제품 출시 또는 데모 비디오를 만들도록 요청할 수 있습니다. 이 스킬은 화면 녹화가 아닌 설명에서 전체 애니메이션을 구축합니다.

왜 중요한가

• 대부분의 AI 생성 모션 비디오는 일련의 단절된 클립(타이틀 카드 → 페이드 → UI 샷 → 페이드 …)으로, 슬라이드쇼처럼 느껴집니다. onetake는 이 문제를 뒤집습니다. 비트 사이의 모든 경계는 화면의 무언가가 살아남아 다음 비트로 변형되도록 설계되었습니다. 이 "캐리"는 자동으로 측정되어 모호한 미적 판단 대신 정량적 연속성 점수를 제공합니다.

주요 기술 아이디어

기능	작동 방식(리포지토리 설명 기준)
UI 재구축	스크린샷은 제품 UI의 HTML 복제본으로 변환되어 카메라 평면에 배치되므로 가상 카메라가 어떤 줌으로든 비행할 수 있습니다 – 화면 녹화 불필요.
모션 라이브러리	약 38개의 순수 함수 모션 프리미티브(스프링, 엔트런스, 충돌, 유체 그라운드, 카메라 이동). 각각은 측정된 속도 곡선을 가진 시간 기반 함수이므로 애니메이션은 결정적이고 반복 가능합니다.
모션 블러	렌더링된 각 프레임은 열린 180° 셔터에서 장면을 여러 번 샘플링하고 선형 광에서 결과를 평균화하여 빠른 이동에 사실적인 블러를 생성합니다.
오디오 통합	폴리와 합성 사운드는 시각적 이벤트와 동일한 가상 룸에 배치됩니다. 히트가 발생하면 음악이 자동으로 덕킹됩니다.
연속성 오라클	probe.py는 각 프레임의 객체를 기록하고, 경계를 찾고, 객체가 "캐리오버"되는지 확인합니다. 영화는 캐리 점수(0-1)를 받습니다. 임계값을 초과하는 점수만 자동 검사를 통과합니다.
결정적 렌더링	동일한 시드 → 모든 타임스탬프에서 동일한 프레임. 드래프트는 1080p 30fps, 최종 렌더링은 4K 60fps.

일반적인 워크플로우

1. 참조 분석 – 참조 비디오를 숫자(정지 시간, 컷 포인트, 이징 곡선)로 분해합니다.
2. 컨셉 브레인스토밍 – 한 문장의 시각적 컨셉을 몇 개 생성합니다(예: "하나의 점이 모든 것이 된다").
3. 비트 시트 – 비트 길이를 정의하고(≥ 4× 변화), 각 경계에서 살아남는 객체를 명시적으로 지정합니다.
4. 작곡 및 렌더링 – 모션 라이브러리를 사용하여 단일 HTML 파일을 작성하고, 모션 블러로 렌더링하고, 스크립트로 사운드를 추가합니다.
5. 검증 – 연속성 오라클을 실행합니다. 통과하면 인간이 볼 수 있는 필름을 표시합니다.

설치 및 사용법

# Claude 에이전트용
 git clone https://github.com/feitangyuan/onetake.git ~/.claude/skills/onetake
# 스킬을 읽는 다른 에이전트용
 git clone https://github.com/feitangyuan/onetake.git ~/.agents/skills/onetake

클론 후 에이전트에게 요청할 수 있습니다:

• "내 앱의 15초 출시 비디오를 만들어 줘."
• "이 스크린샷에서 기능 데모를 만들어 줘, 화면 녹화 없이."
• "내 모션 비디오가 슬라이드쇼처럼 느껴져 – 고쳐 줘."

의존성 – Python 3(playwright + Chromium, numpy, scipy, Pillow, matplotlib, 참조 분석용 선택적 opencv-python), ffmpeg, Node.js, 내레이션용 faster-whisper 및 Kokoro TTS.

라이선스 – PolyForm 비상업 1.0.0(개인, 교육, 연구 목적 무료). 상업적 사용에는 유료 "onetake Pro" 라이선스가 필요하며, 생성된 각 필름의 전체 소스도 제공됩니다.

---

결론: onetake는 측정 가능한 오라클과 물리에서 영감을 받은 모션 프리미티브 라이브러리를 통해 연속성을 강제하여 원활한 원테이크 모션 비디오 생성을 자동화하는 전문 AI 에이전트 스킬입니다. AI 생성 콘텐츠 / LLM 에이전트 도구 공간에 정확히 위치합니다.