Communitygithub.com

jelukas/kaleidos

Kaleidos의 진입점 스킬입니다. 사용자가 "영상을 만들고 싶다"고 말하면 환경을 점검하고, 간단한 질문(어떤 영상, 재료, 템플릿, 스타일, 길이, 포맷)을 한 번에 묻고, BRIEF.md를 작성한 후 적절한 워크플로(발표자 녹화 → Remotion, ElevenLabs 내레이션 → Remotion, 생성형/프로모 → HyperFrames)로 라우팅합니다. Lambda 전에 스틸 확인, AWS 전에 비용 승인, 최종 보고서에 시간과 비용을 포함합니다.

kaleidos란 무엇인가요?

Kaleidos는 새로운 영상 제작 프로젝트를 시작하기 위한 중앙 진입점 스킬입니다. 사용자가 "영상 만들어줘", "새 영상", "뉴스 영상", "익스플레너", "프로모" 등과 같은 의도를 표현하면, 이 스킬이 전체 프로세스를 조율합니다. 먼저 환경 상태(의존성, 권한)를 점검하고, 사용자에게 단 한 번의 질문 라운드로 '재료(발표자 녹화/내레이션/생성형)', '템플릿', '스타일', '포맷'을 물어봅니다. 사용자가 이미 언급한 내용은 자동으로 추론하여 질문을 생략합니다. 이후 요약된 BRIEF.md를 작성하고, 재료 유형에 따라 적절한 하위 워크플로(edicion-ponente, narración, hyperframes)로 라우팅합니다. 이 과정에서 비용이 발생하는 API(voz, Apify)와 AWS Lambda 사용 전에 반드시 사용자 승인을 받으며, 최종 산출물에 대한 품질 확인(스틸, 오디오 정규화)과 함께 시간 및 비용이 포함된 상세 보고서를 제공합니다. 이 스킬은 hyperframes, video-corto, edicion-ponente 등 다른 모든 영상 관련 스킬보다 먼저 실행되어 적절한 스킬을 선택합니다.

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

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

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

문서

영상 제작 (진입)

출처: docs/MONTAR_VIDEO.md. 이 스킬은 실행 스크립트입니다. 세부 사항(추론 표, 전체 명령어, 병렬 처리, 자주 발생하는 문제)은 해당 문서에 섹션(§)별로 인용되어 있습니다. 또한 리포지토리의 CLAUDE.md 규칙을 숙지하세요. 이 규칙이 우선합니다.

단계 0 · 시작 (아무것도 묻지 않음)

  1. 시작 시간: date '+%Y-%m-%d %H:%M:%S'. 저장합니다 (BRIEF.md › 시작 및 보고서에 사용).
  2. node scripts/doctor.mjs (약 1초, 읽기 전용). "준비 완료" 출력 확인. 관련 워크플로에 ✗ 표시가 있다면 → 출력된 해결 방법을 적용합니다 (로컬 및 무료인 경우) 또는 인터뷰 응답과 함께 사용자에게 알립니다.
  3. ls brutos/ proyectos/ 실행. 프로젝트가 이미 존재하면 재개합니다 (BRIEF.md와 informe.md를 읽음). brutos/의 파일명에 사람 이름이 있으면, 채팅에서는 이름 대신 ffprobe로 길이와 해상도를 설명합니다.

단계 1 · 인터뷰: AskUserQuestion 한 번 호출 (3–4개 질문)

먼저 사용자의 문장에서 가능한 모든 것을 추론합니다 (§2). 사용자가 이미 말한 내용은 묻지 말고, 해당 질문을 예비 질문 중 다음 것으로 대체합니다. 각 질문: 2–4개의 옵션, 추천 옵션을 먼저 레이블에 "(추천)"을 붙이고 그 이유를 설명에 포함. 항상 자유 응답("기타")을 허용합니다. 각 질문의 상세 내용: §1.

#헤더질문옵션 (맥락에 따른 추천)
1재료어떤 영상과 어떤 재료로?발표자 녹화 (brutos/에 원본이 있음) · AI 음성 내레이션 (뉴스, 익스플레너; 녹화 없음) · 생성형 또는 프로모 (HyperFrames)
2템플릿어떤 템플릿?1에 따라: clase-larga / corto-ilustrado · noticias-narracion / explainer-narracion · promo-hyperframes / HyperFrames 워크플로 — 그리고 자유, 템플릿 없음. 1이 열려 있다면: 챕터별 긴 형식 · 짧은 형식 · 자유
3스타일어떤 스타일?카탈로그에서 2개를 골라 참조 경로(estilos/README.md)와 함께 제시 · 웹사이트나 영상에서 새로 만들기 (estilos-video §5). 자유 → 기타
4포맷길이와 포맷?16:9, 템플릿 길이 (Remotion) · 9:16 · 16:9 및 9:16 (video-corto에서 추천). 다른 길이 → 기타

예비 질문 (순서대로): 언어 · 음성 (기본값은 .env의 것, 모델 eleven_v4) · 음악 및 효과 (스타일의 것을 사용하거나 ElevenLabs로 새로 생성) · 폰트 (사용자 제공 또는 공식 조사) · 발표자 크롭 · 대상 및 배포처. 경로별 스타일 추천, 길이 및 실제 예시가 포함된 템플릿: §1 및 §1.1. 필수 항목이 누락된 경우에만 두 번째 질문: 어떤 원본(여러 개일 경우), 주제, URL.

다른 에이전트(Codex…): 질문 번호와 옵션 목록을 포함한 단일 메시지로 동일한 내용 전달.

단계 2 · 브리프

답변을 바탕으로 확정된 내용과 추론된 내용(출처 포함)을 한 문단으로 요약하고 즉시 무료 작업을 시작합니다. plantillas/<템플릿>/BRIEF.md를 기반으로 BRIEF.md를 작성합니다 (§3):

  • Remotion: tools/kaleidos nuevo … (빈 파일 생성) 실행 후, 생성된 파일을 채워진 템플릿으로 대체합니다.
  • HyperFrames: npx hyperframes init 이후 워크플로가 작성합니다 (init은 디렉토리 내 파일이 있으면 거부).

단계 3 · 라우팅 (정확한 명령어는 §4)

재료경로수행할 작업
발표자 녹화§4.1edicion-ponente 스킬을 따릅니다: tools/kaleidos nuevo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo를 백그라운드에서 실행 → 전체 전사본 읽기 → guion.json (plantillas/<템플릿>/의 골조 사용) → linea / media / capitulos
AI 음성 내레이션§4.2tools/kaleidos nuevo <slug> --narracion --estilo milikito --escenario → plantillas/<템플릿>/* 복사 → fuentes.md에 공식 출처 → locucion.json → 병렬로 images.mjs ‖ capture.mjs ‖ voz --simular 및 voz --max-caracteres N → transcribir → python3 plantillas/herramientas/cues.py <slug> → media → linea → media → capitulos
생성형 또는 프로모§4.3/hyperframes 스킬 로드 (video-corto, product-launch-video, general-video… 선택), 프로젝트는 proyectos/<slug>/, 스타일은 init 후 frame.md로
새 스타일 또는 변형§4.4estilos-video 스킬 (§5 새 스타일, §6 변형) 및 사용 전 validar.mjs 통과 확인

내레이션에서 intro.previo는 포함, intro.hasta는 제외; 챕터 제목 레이블의 3,4초 동안 이벤트 없음; 말풍선은 x 0.2–0.25, y 0.16–0.17 (§4.2, 항목 6).

단계 4 · 병렬 처리 (§6)

경합하지 않는 작업은 동시에 실행: voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ 조사 및 대본; preparar --paralelo (GPU로 크롭하는 동안 CPU는 대기) 및 전사본이 준비되는 즉시 대본 작성. 16GB에서는 다음을 동시에 실행하지 않음: recortar + transcribir + pose, 두 개의 GPU 단계, 두 개의 stills.mjs, 또는 el-audio.mjs와 voz. 장시간 프로세스는 전체 로그를 기록하며 백그라운드에서 실행 (ffmpeg에 대해 grep 사용 금지). Lambda는 --concurrencia max 사용.

단계 5 · 체크포인트 (§5)

  1. 유료 API: voz --simular (문자 수 계산) 및 이미지 생성 전 이미지 수 확인; 브리프에서 요청하는 경우에만 Apify 사용, --dry-run 및 --budget 포함.
  2. Lambda 전에 항상 스틸 확인: node motor/scripts/stills.mjs <slug> --at eventos → 시트 열기 (motor/out/stills/<이름>/hoja.jpg) Read로 열고 실제로 확인 및 수정 (코드보다 대본 우선). estilos-video §7로 스타일 준수 확인. HyperFrames: npx hyperframes check --snapshots.
  3. AWS: node motor/scripts/lambda.mjs <slug> --dry-run --concurrencia max → 리소스(함수, 사이트, 비공개 버킷, 업로드), 함수 수, 예상 비용 및 시간 표시 → 명시적 승인 대기. 사용자가 이미 이 요청에서 Lambda 렌더링을 명시적으로 요청했다면: 표시하고 기다리지 않고 실행. 리소스(버킷, 스택, IAM) 생성은 항상 별도의 승인이 필요. 배포된 Lambda가 없는 HyperFrames → 경고하고 로컬 렌더링 또는 배포 옵션 제공.
  4. 출력: ffprobe + 프레임 수 계산, 분당 한 프레임 시트, python3 plantillas/herramientas/normalizar_audio.py resultados/<slug>.mp4 --en-sitio (Lambda 출력은 약 −13 LUFS).
  5. 최종 보고서 (proyectos/<slug>/informe.md + 채팅 요약): 길이, 구조, 확인 사항(샘플링된 프레임, 전체 시청 아님), 경고, 불일치, 총 소요 시간 (시작 → MP4 확인, work/logs/tiempos.json 분석 포함) 및 비용 (실제 Lambda + S3 + 전송; work/voz/manifest.json의 ElevenLabs 문자 수; 이미지; Apify). 추정 금액 없음: 가격을 모르면 소비된 수량을 제시. AWS에 남아 있는 것을 알림.

절대 위반하지 않는 규칙 (§8 및 §9)

  • 개인정보 보호: 응답, 보고서, 그래픽 또는 레이블에 고객의 개인 데이터를 포함하지 않음; 개인 데이터가 포함된 전사본 일부를 인용하지 않음; 화면에 나타나는 개인 데이터는 모자이크 처리. 일반적인 레이블 사용.
  • .env: 값을 절대 표시하거나 URL에 포함하지 않음; doctor는 이름만 제공.
  • 콘텐츠: 그래픽은 음성 내용을 요약; 허위 내용 금지; 최신 정보는 공식 출처만 사용, fuentes.md에 날짜와 함께 인용 (웹사이트 다운로드가 403을 반환하면 내장 브라우저로 읽기); 불일치 사항은 보고서에 기록; 법적 또는 임상 내용 → 전문가 검증 필요.
  • brutos/ 및 ~/videos-opus는 읽기 전용. Remotion 4.0.529 정확히 사용. OFL/Apache 라이선스 폰트만 사용.

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

>- Produce vídeos cortos, muy dinámicos y con cortes rápidos para YouTube, Shorts, TikTok o Reels, en formato vertical Y horizontal a la vez, con locución generada (ElevenLabs), música y efectos, B-roll de gpt-image-2, fotografía real vía Apify y montaje HTML+GSAP con HyperFrames. Úsala siempre que el usuario pida un vídeo, un explainer, un vídeo de una noticia, un short, un reel, un vídeo de TikTok o de YouTube, un vídeo con voz en off o locución, un vídeo animado con datos o cifras, o quiera convertir un texto, un guion o una noticia en vídeo — aunque no mencione HyperFrames, ElevenLabs ni ninguna herramienta concreta. Úsala también para retocar, alargar, reencuadrar o volver a renderizar un vídeo ya hecho con este flujo.

관련 스킬