Communitygithub.com

assafkip/claude-video-editor

짧은 형식의 세로(9:16) 비디오(예: TikTok/Reels/Shorts 스타일)를 Hyperframes로 제작하고 반복 개선합니다. 얼굴 영상, 동기화된 장면 오버레이, 가라오케 자막이 포함된 1080x1920 구성에 사용합니다.

claude-video-editor란 무엇인가요?

이 스킬은 Hyperframes 프레임워크 상에서 동작하는 전문 비디오 편집 도구로, 소셜 미디어용 짧은 형식 세로 동영상(1080x1920, 10~30초) 제작을 자동화합니다. 주로 화면 분할 모드의 얼굴 영상, 모션 그래픽 오버레이, 가라오케 스타일 자막을 결합하여 TikTok/Reels/Shorts에 적합한 콘텐츠를 생성합니다. 스킬은 오디오를 최우선으로 하여 편집 후 타임라인을 동기화하고, 4레이어 구성(배경, 얼굴, 장면 오버레이, 자막)을 제공합니다. 또한 May Shorts 19 플레이북의 10가지 품질 체크리스트(데드 프레임 금지, 장면 전환 다양화, 얼굴 보정 등)를 포함하여 사용자에게 전문적인 결과물을 보장합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 호환되며, 오디오 중심 편집, 정밀한 타임라인 동기화, 그리고 자동화된 검증 프로세스를 통해 수동 편집의 번거로움을 줄여줍니다.

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

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

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

문서

단편 세로 비디오 (Hyperframes)

단편 비디오 = 1080x1920 세로, 10~30초, 얼굴 영상 + 모션 그래픽 장면 오버레이 + 가라오케 자막. 이 스킬의 모든 내용은 May Shorts 19 반복 분석(v1 → v4)에서 추출되었으며, 모든 새로운 단편 비디오에 적용되어야 합니다.

항상 먼저 /hyperframes를 호출하세요. 이 스킬은 그 위에 위치합니다 — 프레임워크 규칙(data-* 속성, window.__timelines, 구성 구조)을 대체하지 않습니다. 이러한 규칙은 형식과 관계없이 절대적으로 지켜야 합니다.

이 스킬이 실행되는 경우

  • "단편 비디오 만들기", "TikTok 게시물", "Reels", "Shorts", "세로 비디오"
  • 소셜 미디어용 얼굴 녹화 + 대본/트랜스크립트로 시작하는 모든 제작
  • 기존 단편 비디오의 리타이밍, 재편집, 또는 재동기화
  • 음성 해설에 동기화된 가라오케 자막 추가

플레이북 (상위 수준)

  1. 오디오가 진리입니다. 오디오를 먼저 편집하세요(재녹음, 일시 중지 제거). <name>-edit.mp4로 저장하세요. ffprobe로 정확한 길이를 측정하세요 — 이것이 구성의 data-duration입니다.
  2. 편집된 오디오를 전사하세요: npx hyperframes transcribe <edit>.mp4 --model small.en --json. 또는 기존 자막에 shift() 함수가 있는 경우 기존 자막을 유지하고 장면 시작만 이동하세요.
  3. 편집된 시간으로 장면 경계를 작성하세요 — 절대 원본 시간과 편집 시간 앵커를 같은 파일에 혼용하지 마세요. "오디오 동기화 프로토콜"을 참조하세요.
  4. 구성 뼈대를 만드세요 (4개 레이어: 주변 배경, 이음새 처리, 자막, 얼굴) — 아래 "구성 뼈대"를 참조하세요.
  5. 각 장면의 data-start를 기준으로 상대적인 LOCAL 오프셋으로 장면을 작성하세요. 각 장면은 compositions/scene<N>-<label>.html 아래의 자체 하위 구성입니다.
  6. 린트 → 드래프트 렌더링 → 단어 정확도 프레임 검증 → 최종 렌더링. 이것이 검증 게이트입니다. 3단계(프레임 검증)를 절대 건너뛰지 마세요.

구성 뼈대 (항상 켜져 있는 4개 레이어)

모든 단편 세로 비디오는 compositions/ 아래에 이 4개의 하위 구성을 가지며, 공유 트랙에 로드됩니다:

index.html (루트, 1080x1920, data-composition-id="main")
├── ambient-bg.html        track-index="3" — 방사형 그라데이션 + 드리프트 그리드 + 입자 + 비네트
├── face-wrapper + <video> track-index="0" — 얼굴 영상 (얼굴 모드 안무 참조)
├── seam-treatment.html    track-index="5" — y=960 가장자리 깃털 (하단 절반 장면만 해당)
├── scene1-<label>.html    track-index="1" — 장면 오버레이 (연속, 간격 없음)
├── scene2-<label>.html    track-index="1"
├── …
└── captions.html          track-index="2" — 가라오케 자막, 단어 동기화
  • data-duration은 루트, ambient-bg, seam-treatment, face-video, face-audio, captions 전체에서 동일합니다. 장면 오버레이만 시간에 따라 변경됩니다.
  • 얼굴 <audio>는 별도의 요소(믹서가 필요함)이며, 비디오 자체 오디오 트랙을 사용하지 마세요.
  • class="clip"은 시간 지정 div에만 사용하세요 — <video>나 <audio>에는 절대 사용하지 마세요.

얼굴 모드 안무 (단편 비디오의 핵심 동작)

얼굴은 소스의 기본 가로(1920x1080) 크기로 설정된 래퍼 div 안에 있습니다. GSAP은 래퍼를 애니메이션합니다(비디오 요소는 절대 애니메이션하지 마세요 — <video> 크기를 애니메이션하면 프레임이 멈춥니다).

두 가지 모드:

const BOTTOM     = { x: 0,       y: 1136, scale: 0.5625 }; // 하단 절반, 전체 가로 보임
const FULLSCREEN = { x: -1166.5, y: 0,    scale: 1.7778 }; // 잘린 커버, 1080x1920 채움
const MODE_DUR = 0.32;

BOTTOM은 1920x1080 소스를 1080x607.5로 렌더링하여 하단 960px 중앙에 배치합니다. FULLSCREEN은 가로로 잘라 세로 프레임을 채웁니다.

새 장면의 콘텐츠가 도착하기 0.15초 전에 전환하고, ease: "expo.inOut"을 사용하세요:

[
  { t: <scene-4-start>, mode: FULLSCREEN },
  { t: <scene-5-start>, mode: BOTTOM },
  …
].forEach(({ t, mode }) => {
  mainTl.to("#face-wrapper", { ...mode, duration: MODE_DUR, ease: "expo.inOut" }, t - 0.15);
});

얼굴 모드가 즉시 전환되는 것은 세로 비디오에서 가장 어색한 프레임입니다. 항상 보간하세요.

얼굴 보정 (모든 단편, 예외 없음)

#face-video {
  filter: contrast(1.08) saturate(1.08) brightness(0.97);
}

전체 기간에 걸친 미묘한 1.00 → 1.025 Ken Burns 줌(ease: "none")과 측면 비네트 ::after 의사 요소를 추가하여 얼굴이 날카로운 가장자리와 부딪히지 않고 주변 네이비 색상에 자연스럽게 녹아들게 합니다.

이음새 처리 (하단 절반 장면에 필수)

y=960에 네이비 → 투명 그라데이션 밴드(60–100px)와 부드러운 광택이 있는 2px 강조 스캔 라인. 얼굴 위에 위치하도록 얼굴 다음에 그립니다. 전체 화면 장면이 덮을 때 이를 덮습니다. 날카로운 y=960 절단선은 AI 편집 콘텐츠의 두 번째 징후입니다(배경 평탄성 다음으로).

오디오 동기화 프로토콜 (건너뛰지 마세요)

문제: 오디오가 편집된 경우(재녹음/일시 중지 제거), 소스 트랜스크립트의 타임스탬프가 더 이상 편집된 비디오와 일치하지 않습니다. 원본 시간으로 작성된 장면 시작은 늦게 실행됩니다.

규칙: 모든 타이밍은 편집된 시간에 있습니다. 절대 혼용하지 마세요.

단편 비디오 리타임을 위한 검증 절차:

  1. 두 오디오 파일의 길이를 측정하세요:
    ffprobe -v error -show_entries format=duration -of csv=p=0 assets/original.mp4
    ffprobe -v error -show_entries format=duration -of csv=p=0 assets/<name>-edit.mp4
    
    차이 = 총 절단 시간.
  2. captions.html에 shift() 함수를 사용하여 트랜스크립트 단어를 매핑하는 경우, 이를 진리로 취급하세요. shift(originalTime) = editedTime 매핑은 모든 장면의 data-start에도 적용됩니다.
  3. 장면 내부 오프셋(compositions/sceneN.html 내부)은 장면의 data-start 기준 LOCAL입니다. 장면의 부모 data-start가 편집된 시간에서 올바르면, 내부 오프셋은 수정 없이 올바르게 유지됩니다 — 단, 장면이 절단을 가로지르는 경우 제외하며, 이 경우 부모 길이와 내부 오프셋이 모두 변경됩니다.
  4. 얼굴 모드 전환 배열 시간은 반드시 편집된 시간을 사용해야 합니다. 자동으로 변경되지 않습니다.

리타임 계획 형식 (매번 이 테이블 구조를 사용하세요):

장면현재 시작현재 길이새 시작새 길이이유
..................

그런 다음 얼굴 모드 배열, 내부 오프셋 변경 사항, 그 다음 프레임 검증 목록을 작성하세요.

장면 작성

하나의 장면 = 하나의 하위 구성 파일. 장면은 같은 data-track-index에 연속으로 배치됩니다(간격 없음). 각 장면 내부:

  • data-duration은 부모 슬롯과 정확히 일치합니다.
  • 모든 GSAP 앵커는 LOCAL입니다(장면 시작 기준 0부터).
  • tl.set({}, {}, <data-duration>)을 사용하여 타임라인을 패딩하여 GSAP tl.duration()이 data-duration과 일치하도록 합니다.

장면 페이싱 규칙 (10가지 원칙에서)

  • 데드 프레임 없음. 매 100ms마다 ≥1개 이상의 애니메이션 요소가 있습니다. 첫 진입은 0.1–0.3s 오프셋, t=0이 아닙니다.
  • 페이오프 ≥ 1s 유지. 장면의 "큰 공개"(스탬프, 숫자 잠금, 펀치라인)는 화면에 ≥1s, 이상적으로 1.5s 동안 표시되어야 합니다. 총 시간이 아닌 공개 시간으로 장면을 예산하세요.
  • 전체 기간 동안 모션. 4초 장면에서 진입 애니메이션이 로컬 2초까지 모두 완료되면, 두 번째 모션(밑줄 스윕, 체크 표시 팝, 카드의 주변 표류, 필의 작은 진동 광택)을 추가하세요. 죽은 페이싱 = 스와이프 아웃.
  • 이즈를 다양화하세요. 장면당 최소 3개의 다른 이즈를 진입에 사용하세요.
  • 실행 시간 5초당 하나의 놀라운 장면. 타이포그래피 슬램, 글리치/크로매틱 공개, 휩-팬, 오디오 동기 슬램. 이것들이 없으면 비디오는 "레이블이 붙은 얼굴 영상"으로 읽힙니다 — 정확하지만 잊혀집니다.

자막 (가라오케 스타일)

  • Montserrat 900, 46–58px(1080 너비 기준), 100% 흰색 기본
  • 활성 단어: scale-1.08 팝 + 강조 색상으로 변경 (#37bdf8 AIS의 경우, 브랜드에 맞게 조정)
  • 계층화된 text-shadow를 통한 획, 절대 -webkit-text-stroke 사용 금지 (Chromium 렌더링에서 일관성 없음)
  • rgba 배경 필을 제거하세요 — 획이 가독성을 유지합니다. 자막은 자막 트랙이 아닌 프레임 위의 그래피티처럼 느껴져야 합니다.
  • 리타임의 경우 captions.html 내의 shift() 함수를 사용하여 트랜스크립트 단어 타임스탬프 → 편집된 시간으로 매핑하세요. 이렇게 하면 트랜스크립트 JSON이 변경되지 않고 리타임이 기계적으로 이루어집니다.

전체 가라오케 구현은 /hyperframes 아래의 references/captions.md를 참조하세요. 요약: 단어별 <span> 요소( data-word-start 포함), 각 범위에 범위가 지정된 GSAP 트윈, 0.08–0.12s의 짧은 팝 지속 시간.

주변 배경 (절대 평평한 네이비로 배송하지 마세요)

최소한의 배경 스택:

  1. 방사형 그라데이션 기본 (중앙이 가장자리보다 15–20% 밝음)
  2. 애니메이션 노이즈/그레인 오버레이 (8–12% 불투명도)
  3. 4–8개의 표류 입자 점 또는 그리드 트레이스
  4. 미묘한 비네트

background: #07121c만으로는 디자인이 아닌 자리 표시자입니다. 기술/컨트롤룸 미학을 위해 feedback_techy_background_layers.md의 6레이어 스택(HUD 그리드가 비네트로 마스킹됨 + 회로 트레이스 + 펄스 노드 + 스캔 빔 + 원격 측정 티커 + 코너 모노 레이블)을 사용하세요.

오디오 반응성

  • 헤드라인은 비트에 맞춰 3–6% 맥동합니다. 배경은 저음에 10–30%까지 갈 수 있습니다.
  • 텍스트 반응성은 미묘하게 유지(3–6%)하여 자막이 읽기 쉽도록 하고, 배경은 더 강하게 밀 수 있습니다.
  • 시드가 있는 오프라인 분석기(오디오 특성 트랙 사전 계산)를 사용하여 렌더링이 결정적이도록 하세요. 렌더링 경로에서 AnalyserNode를 사용하지 마세요 — Math.random()과 실시간 오디오 노드는 결정성을 깨뜨립니다.

전환

  • 맛을 다양화하세요. 연속으로 두 개의 동일한 전환 유형이 없어야 합니다. 6번의 하드 컷이 연속되면 AI 편집의 첫 번째 징후입니다.
  • 얼굴 모드 전환(BOTTOM ↔ FULLSCREEN)은 장면 간 모드가 변경될 때 장면 전환 역할을 합니다.
  • 순수 오버레이 장면 간 전환의 경우 레지스트리에서 설치하세요: push-up, flash-through-white, sdf-iris 또는 전체 셰이더 전환 팩. npx hyperframes catalog --type block으로 탐색하세요.

검증 게이트 (필수 — 검증 없이 배송하지 마세요)

린트 통과 ≠ 디자인 작동. 단어 정확도 타임스탬프에서 프레임을 추출하고 모든 PNG를 READ할 때까지 단편 비디오 렌더링이 완료되었다고 보고하지 마세요.

1단계 — 드래프트 렌더링

cd video-projects/<slug>
npx hyperframes lint
npx hyperframes render --quality draft --output renders/<slug>-vN-draft.mp4

2단계 — 단어 정확도 프레임 추출

특정 시각적 요소가 화면에 표시되어야 하는 말한 단어에 해당하는 타임스탬프 8~15개를 선택하세요. 반올림 숫자나 장면 중간이 아닙니다. 정확한 단어여야 합니다.

mkdir -p renders/frames-vN
for pair in "<t>:<label>" "<t>:<label>" ...; do
  t="${pair%%:*}"; label="${pair##*:}"
  ffmpeg -y -ss "$t" -i renders/<slug>-vN-draft.mp4 \
    -frames:v 1 -q:v 2 "renders/frames-vN/t${t}-${label}.png"
done

3단계 — 모든 PNG 읽기

모든 PNG에 대해 Read를 호출하여 이미지가 컨텍스트에 로드되도록 하세요. 파일 이름만 나열하지 마세요. 각 프레임에 대해 다음을 확인하세요:

  • 예상 시각적 요소가 예상 시간에 화면에 표시됨(1초 늦지 않음, 빠르지 않음)
  • 화자의 얼굴이 하단 절반 장면에서 잘리지 않음
  • 전체 화면 vs 하단 절반 얼굴 모드가 해당 장면에 올바름
  • 자막이 브랜드에 맞고, 읽기 쉬우며, 넘치지 않음
  • 빈 프레임, 의도하지 않은 중복, 화면 밖 텍스트 없음

4단계 — 실패 시 수정 후 재검증. 절대 깨진 상태로 배송하지 마세요.

5단계 — 최종 렌더링

npx hyperframes render --quality standard --output renders/<slug>-vN.mp4

최종 렌더링에서 3~4개의 프레임을 스팟 체크하여(같은 타임스탬프, 다른 폴더 frames-vN-final/) 표준 품질 인코딩이 아무것도 변경하지 않았는지 확인하세요.

10가지 규칙 (품질 체크리스트 — 첫 번째 드래프트 전에 실행)

모든 단편 비디오 제작. 작성 중에 이 목록을 실행하고, 이후에는 실행하지 마세요.

  1. 데드 프레임 없음. 매 100ms마다 애니메이션 요소가 있습니다.
  2. 장면 페이오프 ≥ 1s 유지. 총 시간이 아닌 공개 시간으로 예산을 세우세요.
  3. 얼굴은 캐릭터입니다. 보정 + Ken Burns + 측면 비네트.
  4. 단단한 이음새 없음. y=960을 그라데이션 + 스캔 라인으로 깃털 처리하세요.
  5. 실행 시간 5초당 하나의 놀라운 장면. 타이포그래피 슬램, 글리치, 휩-팬, 오디오 슬램.
  6. 오디오 반응성은 협상 불가. 텍스트 3–6%, 배경 10–30%.
  7. 전환 맛을 다양화하세요. 연속으로 두 개의 동일한 유형이 없어야 합니다.
  8. 자막은 팝하며, 정중하게 레이블을 붙이지 않습니다. 획, 필이 아닙니다. 활성 단어에 스케일 + 색상.
  9. 전체 장면 기간 동안 모션. 진입이 일찍 끝나면 두 번째 모션을 추가하세요.
  10. 배경은 레이어이지 색상이 아닙니다. 최소 방사형 + 노이즈 + 입자 + 비네트.
  11. 슬램/스탬프 오버레이는 목표 텍스트가 완전히 보인 후에 나타납니다. 공개 로직 > 단어 동기화. 스탬프 t ≥ 대상-가시 t + 0.10–0.25s. 그렇지 않으면 펀치라인이 설정 전에 나타납니다.

프로젝트 구조 (모든 단편 비디오 프로젝트)

video-projects/<slug>/
├── hyperframes.json
├── meta.json                    (id, name, dimensions 1080x1920, fps 30)
├── index.html                   (루트 구성, 4레이어 뼈대)
├── compositions/
│   ├── ambient-bg.html
│   ├── seam-treatment.html
│   ├── captions.html            (리타임 시 shift() 함수 포함)
│   ├── scene1-<label>.html
│   ├── scene2-<label>.html
│   └── ...
├── assets/
│   ├── <name>.mp4               (원본 녹음)
│   ├── <name>-edit.mp4          (편집됨 — 절단 제거 — 구성이 사용하는 것)
│   ├── transcript.json          (Whisper 출력)
│   └── 브랜드 자산 (로고, brand-tokens.css, 배경 음악)
└── renders/
    ├── <slug>-v1-draft.mp4
    ├── frames-v1/
    ├── <slug>-v1.mp4
    └── ...

리타임 프로토콜 (오디오가 재편집되거나 타임스탬프가 변경될 때)

  1. ffprobe로 이전 및 새 편집된 오디오 길이를 측정하세요. 델타 = 총 절단 시간.
  2. 절단 창을 식별하세요: 어떤 초가, 어디서 제거되었는지.
  3. 계획 테이블을 작성하세요: 모든 장면 data-start, data-duration, 모든 얼굴 모드 전환 t, 내부 오프셋이 절단을 가로지르는 장면.
  4. 각 장면에 대해�

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

assafkip/claude-video-editor

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

assafkip/claude-video-editor

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

assafkip/claude-video-editor

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

관련 스킬