Communitygithub.com

jelukas/kaleidos

Kaleidos のエントリポイント。新しい動画制作を最初から最後まで(環境確認、簡単な質問ラウンド、BRIEF.md の作成、適切なワークフローへのルーティング)実施します。

kaleidos とは?

このスキルは、ユーザーが「動画を制作したい」と言った際に最初に呼び出されるエントリポイントです。環境診断を実行し、動画の種類(講演者収録、AIナレーション、生成・プロモーション)に応じて最大4つの質問を1回の対話で行い、BRIEF.md を作成します。その後、Remotion(講演者編集・ナレーションモード)や HyperFrames などの適切な下流スキルにルーティングします。静的画像のチェック、AWS Lambda デプロイ前のコスト確認、最終レポート(時間・費用)の生成などの制御点を含みます。Claude Code、Codex、Cursor などの AI エージェント向けに設計されており、既存プロジェクトの再編集には使用しません。

対応✓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/ projects/ を確認します。プロジェクトが既に存在する場合は、再開します(BRIEF.md と informe.md を読み、インタビューは行いません)。brutos/ のファイル名に人物名が含まれている場合、チャットではその名前ではなく、ffprobe で再生時間と解像度を説明します。

ステップ1 · インタビュー: AskUserQuestion を1回呼び出し(3~4の質問)

その前に、ユーザーの発言から可能な限り推論します(§2)。ユーザーが既に言ったことは質問しないでください。その質問を予備の次の質問に置き換えます。各質問: 2~4の選択肢、推奨するものを最初に「(推奨)」のラベルとその理由を説明に付けて表示します。常に自由回答(「その他」)を残します。各質問の詳細: §1。

#ヘッダー質問選択肢(コンテキストに応じて推奨)
1素材どんな動画で、どんな素材を使いますか?講演者収録(brutos/ に raw 素材あり) · AI音声ナレーション(ニュース、解説動画;収録なし) · 生成・プロモーション(HyperFrames)
2テンプレートどのテンプレートを使いますか?1に応じて: clase-larga / corto-ilustrado · noticias-narracion / explainer-narracion · promo-hyperframes / HyperFrames フロー — そしてテンプレートなし、自由。1が未確定の場合: 長編チャプター形式 · 短編 · 自由
3スタイルどのスタイルを使いますか?カタログから2つ、該当するもの。参照先のパス付き(estilos/README.md) · Webサイトまたは動画から新規作成(estilos-video §5)。自由 → その他
4フォーマット長さとフォーマットは?16:9、テンプレートの長さ(Remotion) · 9:16 · 16:9 と 9:16(video-corto で推奨)。他の長さ → その他

予備(順番): 言語 · 音声(デフォルトは .env のもの、モデル eleven_v4) · 音楽と効果(スタイルのものか、ElevenLabs で新規) · フォント(ユーザー提供または公式のものを調査) · 講演者の切り抜き · 対象者と公開先。パスによるスタイルの推奨、テンプレートの長さと実際の例: §1 および §1.1。 必須項目で不足がある場合のみ、2回目の質問: どの raw 素材か(複数ある場合)、トピック、URL。

その他のエージェント(Codex…): 同じ内容を1つのメッセージに、質問番号と選択肢をリストにして送信します。

ステップ2 · Brief

回答をもとに、確認済みの内容と推論した内容(出典付き)を1段落にまとめ、無料の作業をすぐに開始します。plantillas/<テンプレート>/BRIEF.md から BRIEF.md を作成します(§3):

  • Remotion: tools/kaleidos nuevo …(空のものを作成)の後、テンプレートの内容で置き換えます。
  • HyperFrames: npx hyperframes init の後にフローが作成します(init はファイルが既にあると拒否します)。

ステップ3 · ルーティング(正確なコマンドは §4)

素材ルート手順
講演者収録§4.1スキル edicion-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.4スキル estilos-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(CPU でポーズ、GPU で切り抜き)と、文字起こしができ次第スクリプト作成。16 GB では同時実行不可: recortar + transcribir + pose、2つの GPU ステップ、2つの stills.mjs、el-audio.mjs と voz。長時間処理は完全なログ付きでバックグラウンド実行(ffmpeg に grep は不可)。Lambda は --concurrencia max を使用。

ステップ5 · 制御点(§5)

  1. 有料 API: voz --simular(文字数)と画像生成前の枚数確認;Apify は brief で要求された場合のみ、--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 → リソース(関数、サイト、プライベートバケット、アップロード)、関数数、推定コストと時間を表示 → 明示的な OK を待つ。ユーザーが既にこのリクエストで Lambda レンダリングを明示的に要求した場合: 表示してすぐに実行。リソースの作成(バケット、スタック、IAM)には常に別途 OK が必要。HyperFrames で Lambda がデプロイされていない場合 → 警告し、ローカルレンダリングかデプロイかを提案。
  4. 出力: ffprobe + フレーム数カウント、1分あたり1フレームのシート、python3 plantillas/herramientas/normalizar_audio.py 結果/<slug>.mp4 --en-sitio(Lambda 出力は約 −13 LUFS)。
  5. 最終レポート(proyectos/<slug>/informe.md + チャットでの要約): 長さ、構造、確認内容(全フレームではなくサンプリング)、警告、矛盾、実経過時間(開始 → MP4 確認完了、work/logs/tiempos.json の内訳付き)、費用(実際の Lambda + S3 + 転送;ElevenLabs の文字数は work/voz/manifest.json から;画像;Apify)。金額をでっち上げないこと: 価格がわからない場合は、消費量を記載します。AWS に何が残っているかを伝えます。

絶対に破ってはいけないルール(§8 および §9)

  • プライバシー: 回答、レポート、グラフィック、タイトルに顧客の個人データを含めない。個人データを含む文字起こしの断片を引用しない。画面に表示されるものはぼかす。タイトルは汎用的に。
  • .env: 値を表示したりURLに入れたりしない。doctor は名前のみを出力する。
  • コンテンツ: グラフィックは音声の内容を要約するもの。捏造しない。時事問題は fuentes.md に日付付きで引用された公式情報源のみを使用(Web サイトがダウンロードに 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.

関連スキル