Communitygithub.com

UgurKeskekci/claude-video-kit

코드만으로 (이미지 생성 모델 없이) 이야기를 전하는 짧은 잉크 선 애니메이션을 제작합니다 — X/Twitter 게시물, Reels/Shorts, YouTube 인트로 또는 콜드 오프닝에 적합합니다. 이미지는 PIL 잉크 엔진으로, 음악과 효과음은 numpy 합성으로 동일한 시간 프로그램에 따라 생성되며, 결과는 계측을 통해 검증됩니다. 다음 경우에 사용: "애니메이션 만들어 줘", "선 애니메이션", "내 상태를 보여 줘", "트위터용 애니메이션", "릴스 애니메이션", "인트로 애니메이션", "막대기 인형 애니메이션", "코드로 비디오", "원샷 애니메이션".

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

이 스킬은 AI 에이전트(Claude Code 등)가 사용자의 상태나 이야기를 코드로만 구현된 짧은 잉크 스타일의 선 애니메이션으로 변환할 수 있게 해줍니다. 이미지 생성 모델에 의존하지 않기 때문에 저작권 문제가 없고, 결과물이 결정적이며 프레임 단위로 수정이 가능합니다. 지원하는 플랫폼은 X/Twitter(4:5), Reels/Shorts(9:16), YouTube 인트로 등이며 각각 15~30초, 20~40초, 3~8초 길이에 최적화됩니다. 작동 방식은 간단합니다: Python 스크립트를 통해 PIL 기반의 `murekkep` 엔진으로 잉크 효과의 이미지를 그리고, `sentez` 엔진으로 numpy를 이용해 악기 음과 효과음을 합성하며, FFMpeg로 영상과 오디오를 결합합니다. 이 스킬의 핵심은 철저한 계측 기반 개발입니다. 애니메이션의 모든 장면, 음악의 비트, 효과음 타이밍은 사전에 초 단위로 계획된 '비트 시트(beat sheet)'를 따릅니다. 결과물은 자동화된 품질 검사(볼륨, LUFS, 음성 프로필, 시각적 전환 등)를 거쳐야만 최종 제출됩니다. 사용자의 요청이 모호할 경우 에이전트가 몇 가지 아이디어를 제시하고 협의할 수 있으며, '원샷' 주장은 실제로 한 번에 생성된 경우에만 사용하도록 투명성을 강조합니다. 전체 워크플로는 논의 → 비트 시트 → 코드 생성 → 미리보기(키프레임 이미지) → 수정 → 전체 렌더 → 계측 → 전달 순으로 진행됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/UgurKeskekci/claude-video-kit/tree/HEAD/.claude/skills/animasyon

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

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

문서

참고: 이 파일은 한국어로 번역되었습니다. 원본은 UgurKeskekci/claude-video-kit에서 확인하세요.

코드로 만드는 잉크 애니메이션

사용자가 어떤 상태나 이야기를 말하면 (예: "일주일째 소셜 미디어만 하다가 미칠 것 같아"), 당신은 그것을 짧고 하나의 아이디어에 집중된 애니메이션으로 변환합니다. 이미지 생성 모델은 사용하지 않습니다: 모든 선은 코드로, 모든 소리는 합성됩니다. 저작권 걱정이 없고, 결과는 결정적이며 프레임 단위로 수정 가능합니다.

작동하는 예제 (템플릿으로 참조): ornekler/animasyon-bir-hafta/ — 7일 타임랩스, 4:5 비율, 17.7초, 프로그래밍된 음악과 효과음.

먼저 읽어보세요: references/ilkeler.md (왜 효과적인지, 플랫폼 표, 주제 찾기, 정직성)와 references/tarifler.md (엔진 선택, 구성, 캐릭터, 사운드, 검증 — 모두 계측을 통해 발견된 함정들).

명령어는 Python으로 .venv/bin/python을 사용하세요 (Windows: .venv\Scripts\python). 의존성: numpy, Pillow, ffmpeg.

워크플로

1. 짧은 논의

아이디어가 불분명하거나 사용자가 "먼저 얘기하자"고 하면: 3-4가지 개념을 제안하세요 (각각 한 문장의 재치 + 효과적인 이유), 그중 하나를 추천하세요. 한 번의 질문 라운드에서 다음을 물어보세요: 아이디어, 비율 (X: 4:5 / 16:9, Reels: 9:16), 길이. 사용자가 "만들지 말고 먼저 얘기하자"고 하면 코드를 작성하지 마세요.

2. 비트 시트 — 코드 작성 전에

초 단위 계획: 각 비트 = 하나의 시각적 아이디어 + 최대 한 문장.

  • 길이: X: 15-30초, Reels: 20-40초, YouTube 인트로: 3-8초. 사용자가 짧게 원하면 하한선 적용.
  • 구조: 앵커 (모서리에 고정 카운터: 일/년) + 반복되는 캐릭터 + 장면당 하나의 객체 + 고조 + 회상하는 결말. 결말이 시작으로 연결되면 영상이 반복됩니다.
  • 사운드의 주요 지점 (비트, 컷, 침묵)은 계획 단계에서 그 순간에 기록하며, 나중에 추가하지 않습니다.

3. 엔진

  • 그리기, 캐릭터, 파티클, 스택 → 이 스킬: kit/murekkep.py + kit/sentez.py.
  • 숫자, 텍스트, 그래픽 위주의 모션 그래픽 (카운터, 막대 그래프, 비교) → x-animasyon 스킬 (Remotion).
import sys; sys.path.insert(0, ".claude/skills/animasyon/kit")
import murekkep as M, sentez as Z

프로젝트 폴더 calisma/<ad>/: anim.py (이미지 + program()), ses.py (같은 프로그램을 읽음). 예제를 복사하여 시작하세요; 경로는 KOK와 CIKTI 상수에서 변경합니다.

구성 요소기능
M.Tuval(w, h)종이 질감 배경 (2배로 그려진 후 bitir()로 축소: 부드러운 가장자리)
M.Kalem(d, kare, s, sc, ox, oy)번지는 잉크 선, 원, 다각형, 텍스트; 장면 변환
M.Iskelet, M.yuru, M.poz_karistir관절형 캐릭터, 절차적 걷기, 포즈 전환
M.yaz_mp4(kare_fn, sure, yol, w, h, ses=wav)프레임을 ffmpeg으로 파이프, 오디오 추가
Z.harp/yayli/bas/flut/taiko악기들 (음정은 계측으로 보정됨)
Z.whoosh/tus/yazma/ding/tik/hisirti/swell효과음 (whoosh 부드러움, 키보드는 인간 리듬)
Z.yanki, Z.kes, Z.yaz_wav(buf, yol, lufs)에코, 코미디 컷, 타겟 LUFS의 WAV 저장

4. 미리보기 → 수정 → 렌더링

전체 렌더링 전에 4-6개의 키 프레임을 PNG로 출력하고 (예제에서는 --kare 2,7.5,15.5) 직접 확인하세요. 첫 번째 시도에서는 항상 무언가 잘못됩니다: 답답한 구성, 텍스트를 가리는 객체, 반복되는 텍스트, 보이지 말아야 할 것이 간격으로 보이는 현상 등. 수정한 후 전체 렌더링을 하세요. 미리보기를 전체 렌더링과 같은 명령어에 연결하세요: 프레임을 보지 않고 긴 렌더링을 시작하지 마십시오.

5. 계측 — 눈과 귀로는 확인할 수 없습니다

.venv/bin/python .claude/skills/animasyon/kit/denetim.py calisma/<ad>/<ad>.mp4

연결된 프레임 수 + LUFS/실제 피크 + 0.5초 음성 프로필 + 시각적 전환. 합성된 음정이 변경되었다면 --perde 플래그 사용. 계획된 침묵, 비트, 컷이 제자리에 있는지 확인하세요. 계측할 수 없는 것 (음색이 좋은지, 농담이 재미있는지)은 사용자에게 명확히 맡깁니다.

6. 전달 및 게시글

파일 경로, 길이, 크기, 계측 요약을 제공하세요. 게시글은 2-3줄: 이야기의 핵심 문장. 정직성: "단일 프롬프트 / 원샷" 주장은 진짜로 한 번에 생성된 경우에만 사용하세요; 여러 번 수정했다면 "한 번에"라고 말하지 마십시오. 어떤 모델이 생성했는지 정확히 밝히세요.

규칙

  • 텍스트는 번지지 않으며, 크기가 조정되지 않습니다; 장면당 한 줄. 이모지는 폰트에 없습니다.
  • 움직이는 객체는 제목/카운터 밴드 영역을 침범하지 않습니다 (들어가기 전에 사라짐).
  • 단일 강조 색상만 사용 (잉크 작업에서는 알림 빨간색); 나머지는 종이 + 잉크.
  • 세로 작업에서 아래 ~520px와 오른쪽 x > 900 영역은 플랫폼 UI 영역입니다: 거기에 텍스트를 넣지 마세요.
  • 오디오: 단독 비디오는 -15 LUFS; 그 아래에 대화가 있을 경우 음악은 대화보다 확실히 작게. 음악은 오직 합성 또는 사용자가 라이선스를 확인한 소스만 사용.
  • 화면에 계측되지 않은 숫자는 없습니다; 예시 숫자라면 그 사실을 명시하세요.
  • 새로운 함정을 발견했다면 references/tarifler.md에 기록하세요; 새로운 영구 구성 요소 (전환, 리깅 추가)가 나왔다면 kit/ 디렉토리에 추가하세요.

Individual skills in this repo

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

UgurKeskekci/claude-video-kit

Konuşan kafa kaydından (kamera, ses içinde; yatay 4K ya da dikey) dikey Instagram Reels / YouTube Shorts / TikTok videosu (1080x1920, 30 fps) üretir, "kart" formatında - üstte söylenen kelimede beliren sade arayüz kartları (sohbet balonu, liste, harf harf yazılan terminal, dosya ağacı, büyük sayı, gerçek ekran görüntüsü), altta yuvarlak köşeli yüz kartı, aralarında kelime kelime altyazı, kart geçişinde yumuşak whoosh, yazarken klavye sesi, sonda "yorumlara yaz" sorusu. Şu durumlarda kullan - "reels yap", "bundan reels çıkar", "shorts yap", "dikey video", "kartlı reels", "bilgi veren reels", "ipucu videosu", "üstte kart altta yüz", "yorumlara yaz diye bitsin", "tips reels".

UgurKeskekci/claude-video-kit

Sayı ve yazıyla hikâye anlatan editoryal hareketli grafik videosu üretir (Remotion) — X/Twitter gönderisi, Reels/Shorts, YouTube video arası. Hikâye JSON sahne listesi olarak yazılır (başlık, yazılan istem, sayaç, ölçer, sütunlar, karşılaştırma, liste, soru), 16:9 ve 9:16 render edilir, yumuşak whoosh + klavye + sakin müzik yatağı numpy ile sentezlenip eklenir, sonuç ölçülerek denetlenir. Şu durumlarda kullan: "X için animasyon/video", "hareketli grafik", "motion graphics", "sayılarla anlat", "sonuçları grafikle göster", "karşılaştırma videosu", "test sonucunu animasyonla anlat", "reels grafiği", "araya grafik", "Remotion".

UgurKeskekci/claude-video-kit

Yatay YouTube konuşma videosunu (kamera kaydı, isteğe bağlı ayrı ekran kaydı) kaba kurgular. Harfiyen döküm çıkarır, duraklamaları ve art arda tekrarları sesten keser; Claude dökümü okuyup gerekçeli bir atma listesi yazar, mp4 üretilir, kesilmiş ses yeniden çözülüp her birleşim denetlenir. Şu durumlarda kullan - "videoyu kurgula", "kaba kurgu", "ham kaydı kes", "beklemeleri/duraklamaları kes", "tekrarları at", "takılmaları temizle", "jump cut", "keseceğim dediğim yerleri at", "kamera ile ekran kaydını senkronla", "ekran kaydının köşesine kamera koy", "sessiz yerleri hızlandır".

관련 스킬