Communitygithub.com

jelukas/kaleidos

단일 소스에서 세로(1080×1920)와 가로(1920×1080) 두 포맷의 MP4 영상을 동시에 생성합니다. ElevenLabs 음성 해설, gpt-image-2 B-roll, Apify 실제 사진, HyperFrames HTML+GSAP 편집을 결합하여 YouTube Shorts, TikTok, Reels 등에 적합한 역동적인 짧은 영상을 제작합니다.

kaleidos란 무엇인가요?

이 스킬은 하나의 대본을 기반으로 세로와 가로 두 가지 포맷의 숏폼 비디오를 동시에 제작하는 AI 에이전트용 워크플로입니다. 사용자가 텍스트, 뉴스 기사, 또는 간단한 아이디어를 입력하면, ElevenLabs의 음성 해설이 리듬을 결정하고, gpt-image-2로 생성된 B-roll 영상, Apify를 통해 수집된 실제 사진, GSAP 애니메이션이 적용된 HTML 장면들이 결합되어 전문적인 explainer 또는 숏폼 콘텐츠가 완성됩니다. 사용자는 HyperFrames, ElevenLabs 등 구체적인 도구 이름을 언급하지 않아도 되며, 영상 제작, 리믹스, 재렌더링 요청 시 이 스킬이 자동으로 활성화됩니다. 이 워크플로는 뉴스 기반 콘텐츠에 대해 사실 확인을 필수로 요구하며, 음성 파일의 실제 타이밍을 기반으로 장면이 자동 정렬되므로 수동 동기화가 필요 없습니다. 또한 `npm run check` 명령어로 렌더링 전 오류를 검증하고, 결과물을 시각적으로 점검할 수 있는 스냅샷 기능을 제공합니다. 개발자는 Node 22+, ffmpeg, 그리고 적절한 API 키만 준비하면 바로 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jelukas/kaleidos/tree/HEAD/skills-globales/video-corto

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

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

문서

듀얼 포맷 숏폼 비디오

하나의 소스에서 두 개의 MP4 파일—세로 1080×1920 및 가로 1920×1080—을 생성합니다. 음성 해설이 리듬을 결정하며, 모든 요소는 이에 종속됩니다.

시작하기 전에: 주제가 뉴스인 경우

대본을 한 줄이라도 쓰기 전에 웹 검색을 통해 사실을 확인하세요. 허위 데이터가 포함된 정보성 영상은 이 스킬의 최악의 결과물이며, 조용한 실패입니다. 영상은 여전히 예쁘게 나오니까요.

요청의 전제가 성립하지 않는다면, 그대로 말하고 실제로 일어난 일을 편집하세요. 거짓 전제에 맞추기 위해 대본을 '순화'하지 마십시오. 대본을 건드리기 전에 references/periodism.md를 읽으세요. 사실 확인, 정보성 콘텐츠의 이미지 처리, 그리고 추적 가능성 파일에 대해 다룹니다.

워크플로

npm run voz -- <slug>       # script.json → assets/voice/*.wav + 타이밍 매니페스트
npm run imagenes -- <slug>  # images.json → 생성형 B-roll
npm run stock -- <slug>     # stock.json  → 실제 사진 (선택 사항, 유료)
npm run audio -- <slug>     # audio.json  → 음악 및 효과음
npm run build -- <slug>     # plan.json   → vertical.html + horizontal.html
npm run use -- <slug> vertical
npm run check               # 필수: 렌더링 전 오류 0개
npm run render -- <slug>    # renders/<slug>-<format>.mp4

프로젝트가 아직 없는 경우: npx hyperframes@latest init . --non-interactive --example blank, 이 스킬의 scripts/와 assets/를 복사하고, package.json에 스크립트를 추가하세요. Node 22+ 및 ffmpeg가 필요합니다. .env에 키를 설정하세요 (템플릿은 assets/env.example에 있음).

구조

videos/_shared/vox.css, timeline.js     모든 비디오에서 공유
videos/<slug>/
  script.json   대본 — 한 줄 = 한 컷
  images.json   생성형 B-roll 프롬프트
  stock.json    실제 사진 검색어
  audio.json    음악 및 효과음
  plan.json     편집 구성: 대본 줄을 참조하는 비트
  scenes/*.html 일회용 애니메이션 서브-컴포지션
  assets/       생성된 파일 + 실제 타이밍 매니페스트
  vertical.html, horizontal.html   build.mjs에 의해 생성됨 — 직접 수정 금지

모든 것을 뒷받침하는 두 가지 아이디어

1. 대본이 시간을 결정합니다. voice.manifest.json은 각 줄의 실제 start와 duration을 제공합니다. plan.json의 비트는 초가 아닌 줄을 참조합니다. 절대 눈대중으로 길이를 추정하지 마세요. 대본을 바꾸고, 음성을 재생성하면 편집이 자동으로 재배치됩니다.

2. 셸은 아티팩트입니다. 수십 개의 컷을 두 포맷으로 수동 동기화하는 것은 불가능합니다. build.mjs는 동일한 plan.json에서 두 포맷을 생성하므로, 둘이 달라질 수 없습니다. 유일한 차이는 스테이지 크기입니다. plan.json을 편집하고 재구축하세요.

한 장면이 9:16과 16:9 모두에서 유효하려면: vw/vh/vmin으로 레이아웃하고 절대 px를 사용하지 마세요; 서브-컴포지션의 루트는 data-width/data-height를 가지면 안 됩니다 (박스는 호스트 슬롯이 결정합니다); 그리고 클래스가 아닌 #root로 스타일링하세요 — 컴파일러의 스코핑이 클래스를 버립니다. 축이 변경되는 레이아웃의 경우, @media (min-aspect-ratio: 1/1)을 사용하세요.

비트 유형

stat (상승 카운트 countTo가 있는 주요 수치) · compare (두 수치 비교) · title (킥커 + 헤드라인 + 리드) · quote (인용 + 출처) · photo (전체 화면 이미지, 그라데이션, 텍스트 및 크레딧 포함) · capture (전체 화면 스크린샷, 출처 포함, 주장의 증거) · scene (일회용 애니메이션 서브-컴포지션).

회사나 제품에 대한 비디오의 경우, 로고와 출처의 스크린샷이 결과를 크게 향상시킵니다. 둘 다 references/imagenes.md에 있습니다.

가장 흔한 디자인 오류: 레이블 캐러셀

텍스트 카드만으로 구성된 비디오는 아무리 좋은 타이포그래피라도 지루합니다. title과 stat이 연속으로 쌓이는 것을 발견하면, 해결책은 더 많은 텍스트가 아닙니다. 바로 의미 있는 움직임입니다.

assets/scenes/에는 SVG로 된 9개의 애니메이션 장면이 포함되어 있어 바로 적용할 수 있습니다: olas, puntos, barras, mapa, cierre, orbita (궤도를 도는 물체), precios (이전/이후 표), caida (백분율과 함께 하락), indice (막대 그래프 순위). 적합한 장면을 videos/<slug>/scenes/로 복사하고 데이터를 변경하세요. 세부 사항 및 성능 규칙은 references/escenas-animadas.md를 참조하세요.

번갈아 사용: 수치 → 사진 → 애니메이션 장면 → 인용 → 사진. 각 컷마다 프레이밍을 변경하세요 (kb: "in" / "out"으로 Ken Burns 효과를 번갈아 사용).

리듬

3분짜리 explainer에서는 비트당 2~6초, 숏에서는 0.8~2.5초. 각 비트는 다음 비트가 시작될 때까지 지속되며, 검은 프레임이 남지 않습니다. fromTo()로 진입하고, 절대 from()을 사용하지 마세요. 호스트가 seek할 때마다 장면을 다시 검색하며 from()은 동기화가 깨집니다.

감정이 담긴 음성

eleven_multilingual_v2는 태그를 무시합니다. 연기를 제어하려면 "modelId": "eleven_v3"를 사용하고, 인라인으로 소문자 태그를 대괄호 안에 넣으세요:

{ "id": "l19", "text": "[somber] 예순일곱 명이 사망했습니다." }

주제에 맞게 톤을 조정하세요 — 사망자가 있는 뉴스에서는 절대 [excited]를 사용하지 마세요. 태그 카탈로그, 설정, 그리고 태그가 큰 소리로 읽히지 않는지 확인하는 방법은 references/audio.md를 참조하세요.

확정하기 전에

npm run check는 오류 0개로 종료되어야 합니다. 그런 다음 비디오를 시청하세요. 프레임 추출 (ffmpeg -ss <t> -i <mp4> -frames:v 1) 또는 npx hyperframes snapshot --at 12,40,90을 사용하면 연락처 시트도 생성됩니다. 린터는 장면이 검은색인지, 텍스트가 벗어났는지, 사진이 설명과 다른지를 감지하지 못합니다.

참고 자료

  • references/hyperframes.md — 렌더를 조용히 깨뜨리는 프레임워크 제약사항. 작곡을 쓰기 전에 읽으세요.
  • references/audio.md — ElevenLabs: v3 태그 음성, 음악, 효과음, 트랙.
  • references/imagenes.md — gpt-image-2 및 Apify, 비용 관리 포함.
  • references/periodismo.md — 뉴스에서 사실 확인 및 이미지 처리.
  • references/escenas-animadas.md — 9개의 SVG 장면, 새 장면 만드는 방법, 하루를 날릴 수 있는 두 가지 함정 (vox.css와의 클래스 충돌, GSAP이 SVG transform을 덮어쓰는 문제).
  • references/sistema-visual.md — explainer 스타일의 팔레트 및 타이포그래피.

Individual skills in this repo

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

jelukas/kaleidos

>- Catálogo de guías de estilo de vídeo de kaleidos (estilos/): listar los estilos con sus referencias, aplicarlos a un proyecto del motor de Remotion o a un proyecto HyperFrames, recomendar 2–3 cuando no se indica ninguno, crear estilos nuevos (desde una web, una marca, un vídeo de referencia o una descripción), crear variantes y revisar la adherencia de un vídeo a su estilo antes de renderizar. Úsala cuando el usuario diga «con el estilo X», «en estilo curso-azul», «como el de Ensaya», «como el vídeo de la cabaña», «qué estilos hay», «enséñame los estilos», «qué estilo me recomiendas», «crea un estilo a partir de esta web», «saca el estilo de esta marca», «haz un estilo como este vídeo», «usa el estilo X pero con acento Y», «una variante de X más seria/más oscura/vertical», «revisa que el vídeo cumple el estilo», o cuando empiece un vídeo nuevo sin estilo decidido.

jelukas/kaleidos

>- Puerta de entrada de kaleidos para montar un vídeo NUEVO conversando, de principio a fin: comprueba el entorno, hace UNA ronda corta de preguntas (qué vídeo y con qué material, plantilla, estilo, duración y formato), escribe BRIEF.md y lo enruta al flujo adecuado (grabación con ponente → Remotion edicion-ponente; narración con voz de ElevenLabs → Remotion modo narración; generativo o promo → HyperFrames), con stills antes de Lambda, OK con coste antes de AWS e informe final con tiempo y coste. Úsala cuando el usuario diga «quiero montar un vídeo», «quiero hacer/crear un vídeo», «monta un vídeo», «vídeo nuevo», «hazme un vídeo de…», «necesito un vídeo sobre…», «empecemos un vídeo», «un vídeo con las noticias de…», «un explainer de…», «una promo de…» o similares. En este repo va ANTES que hyperframes, video-corto, product-launch-video, general-video y edicion-ponente: ella decide cuál usar. No la uses para retocar o re-renderizar un proyecto que ya existe (eso lo retoma su propia skill).

관련 스킬