Communitygithub.com

ComeOnOliver/skillshub

プロジェクト向けのショート動画クリップ(製品デモ、マーケティングスポット、映画的なショット、UIモックなど)を作成・管理します。デフォルトは`sora-2`モデルと構造化プロンプト拡張ワークフローを使用し、決定論的な実行のためにバンドルされたCLIを優先します。注: `$sora`はプロンプト内のスキルタグであり、シェルコマンドではありません。

skillshub とは?

このスキルは、OpenAIのSora API(sora-2およびsora-2-proモデル)を利用して、ショート動画クリップの生成、リミックス、ステータス確認、ダウンロード、バッチ処理をコマンドラインから実行するためのツールです。プロダクトデモ、マーケティングスポット、映画的なショット、UIモックなど、プロジェクトで必要な動画アセットを効率的に作成できます。バンドルされたCLI(scripts/sora.py)を使用することで、決定論的で再現性のあるワークフローを実現します。主な機能として、プロンプトからの動画生成(create)、既存動画のリミックス(remix)、ジョブステータスのポーリング(status)、アセットのダウンロード(download)、複数プロンプトの一括処理(batch)をサポートします。プロンプト拡張機能により、ユーザーの意図に基づいて構造化されたプロダクション向け仕様に自動整形します。認証にはOPENAI_API_KEYが必要で、動画生成は非同期で行われ、完了をポーリングしてからダウンロードします。注意点として、ダウンロードURLは約1時間で期限切れになるため、アセットはローカルにコピーする必要があります。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/openai/skills/sora

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Sora 動画生成スキル

プロジェクト向けのショート動画クリップ(製品デモ、マーケティングスポット、映画的なショット、UIモックなど)を作成・管理します。デフォルトはsora-2モデルと構造化プロンプト拡張ワークフローを使用し、決定論的な実行のためにバンドルされたCLIを優先します。注: $soraはプロンプト内のスキルタグであり、シェルコマンドではありません。

使用タイミング

  • プロンプトから新しい動画クリップを生成する場合
  • 既存の動画をIDでリミックスする場合
  • ステータスのポーリング、ジョブ一覧、アセット(動画/サムネイル/スプライトシート)のダウンロードを行う場合
  • バッチ実行(多数のプロンプトやバリエーション)の場合

決定ツリー(作成 vs リミックス vs ステータス/ダウンロード vs バッチ)

  • ユーザーが動画IDを持ち、変更を希望する場合 → リミックス
  • ユーザーが動画IDを持ち、ステータスやアセットを希望する場合 → ステータス/ポーリング/ダウンロード
  • ユーザーが多数のプロンプト/アセットを必要とする場合 → create-batch
  • ユーザーが小さな変更で2つのバージョンを要求する場合(同じショット、異なる被写体/詳細) → ベースを作成し、バリエーションをリミックスする
  • その他の場合 → 作成(または1ステップで準備完了アセットが必要な場合はcreate-and-poll)

ワークフロー

  1. 意図を決定する: 作成 vs リミックス vs ステータス/ダウンロード vs バッチ
  2. 入力を収集する: プロンプト、モデル、サイズ、秒数、入力参照画像(ある場合)
  3. バッチの場合: tmp/以下に一時的なJSONLファイルを書き込む(1行1ジョブ)、1回実行した後、JSONLを削除する
  4. 事前に構造化プロンプトを記述する代わりに、CLIの拡張フラグ(--use-case、--scene、--cameraなど)を優先する。すでに構造化プロンプトファイルを作成している場合は、--no-augmentを渡して二重ラップを避ける
  5. バンドルされたCLI(scripts/sora.py)を適切なデフォルトで実行する(references/cli.md参照)。長いプロンプトの場合は、シェルエスケープの問題を避けるために--prompt-fileを優先し、プロンプトがすでに構造化されている場合は--no-augmentを組み合わせる
  6. 非同期ジョブの場合は、完了するまでポーリングする(またはcreate-and-pollを使用する)
  7. アセット(動画/サムネイル/スプライトシート)をダウンロードし、ローカルに保存する
  8. 呼び出し中に作成された中間ファイルを削除する(例: prompt.txt、remix_job.json、一時JSONL)。サンドボックスがrmをブロックする場合は、クリーンアップをスキップするか、エラーを表示せずにファイルを空にする
  9. プロンプトごとに1つの対象を変えて反復する

認証

  • ライブAPI呼び出しにはOPENAI_API_KEYが設定されている必要があります。

キーがない場合、ユーザーに以下の手順を案内してください:

  1. OpenAIプラットフォームUIでAPIキーを作成: https://platform.openai.com/api-keys
  2. システムの環境変数としてOPENAI_API_KEYを設定する
  3. 必要に応じて、OS/シェルに合わせた環境変数の設定方法を案内する
  • チャットで完全なキーを貼り付けるようユーザーに依頼しないでください。ローカルに設定し、準備ができたら確認を求めてください。

デフォルトとルール

  • デフォルトモデル: sora-2(高忠実度にはsora-2-proを使用)
  • デフォルトサイズ: 1280x720
  • デフォルト秒数: 4(許容値: "4"、"8"、"12" の文字列)
  • サイズと秒数は常にAPIパラメータで設定します。文章では変更されません
  • OpenAI Python SDK(openaiパッケージ)を使用します。生のHTTPは使用しません
  • ライブAPI呼び出しの前にOPENAI_API_KEYを必要とします
  • uvキャッシュの権限に失敗した場合、UV_CACHE_DIR=/tmp/uv-cacheを設定します
  • 入力参照画像はjpg/png/webp形式で、ターゲットサイズと一致する必要があります
  • ダウンロードURLは約1時間で期限切れになります。アセットは自分のストレージにコピーしてください
  • バンドルされたCLIを優先し、ユーザーが明示的に依頼しない限りscripts/sora.pyを変更しないでください
  • Soraは音声を生成できます。ユーザーがナレーションや音声を要求した場合、Audio:およびDialogue:行で明示的に指定し、短く保ちます

API制限

  • モデルはsora-2とsora-2-proに制限されています
  • SoraモデルへのAPIアクセスには、組織確認済みのアカウントが必要です
  • 動画の長さは4/8/12秒に制限されており、secondsパラメータで設定する必要があります
  • APIはsecondsを文字列列挙型("4"、"8"、"12")として期待します
  • 出力サイズはモデルによって制限されます(サポートされているサイズはreferences/video-api.mdを参照)
  • 動画作成は非同期です。ダウンロード前に完了をポーリングする必要があります
  • レート制限は使用階層によって異なります(具体的な制限は列挙しないでください)
  • コンテンツ制限はAPIによって適用されます(下のガードレールを参照)

ガードレール(必ず遵守)

  • 18歳未満の視聴者に適したコンテンツのみ
  • 著作権で保護されたキャラクターや音楽は使用不可
  • 実在の人物(公人を含む)は使用不可
  • 人間の顔を含む入力画像は拒否されます

プロンプト拡張

プロンプトを構造化されたプロダクション向け仕様に再フォーマットします。暗黙の詳細のみを明示的にし、新しいクリエイティブ要件を考案しないでください。

テンプレート(関連する行のみを含める):

Use case: <クリップの使用場所>
Primary request: <ユーザーのメインプロンプト>
Scene/background: <場所、時間帯、雰囲気>
Subject: <メインの被写体>
Action: <単一のはっきりしたアクション>
Camera: <ショットタイプ、アングル、動き>
Lighting/mood: <照明 + ムード>
Color palette: <3-5のカラーアンカー>
Style/format: <映画/アニメーション/フォーマットの手がかり>
Timing/beats: <カウントまたはビート>
Audio: <アンビエントキュー / 音楽 / ナレーション(要求された場合)>
Text (verbatim): "<正確なテキスト>"
Dialogue:
<対話>
- Speaker: "短いセリフ。"
</対話>
Constraints: <必ず維持/避けること>
Avoid: <否定的な制約>

拡張ルール:

  • 短く保ち、ユーザーがすでに暗示または他の場所で提供した詳細のみを追加します
  • リミックスでは、不変条件を明示的にリストします(「同じショット、Xのみ変更」)
  • 成功を妨げる重要な詳細が欠けている場合は質問します。それ以外は進めます
  • 構造化プロンプトファイルをCLIに渡す場合は、ツールによる再ラップを避けるために--no-augmentを追加します

例

生成例(単一ショット)

Use case: 製品ティーザー
Primary request: マットブラックのカメラが台座に載っているクローズアップ
Action: 4秒間で30度のスローオービット
Camera: 85mm、浅い被写界深度、優しい手持ちドリフト
Lighting/mood: ソフトなキーライト、繊細なリムライト、プレミアムスタジオの雰囲気
Constraints: ロゴなし、テキストなし

リミックス例(不変条件)

Primary request: 同じショットとフレーミング、パレットをティール/サンド/ラストに変更し、暖かいバックライトを追加
Constraints: 被写体とカメラの動きは変更しない

プロンプトのベストプラクティス(短いリスト)

  • ショットごとに1つのメインアクション + 1つのカメラムーブ
  • タイミングにはカウントまたはビートを使用(「2歩、ポーズ、ターン」)
  • UIや画面上のテキストには、テキストを短くしカメラを固定する
  • アーティファクト(フリッカー、ジッター、速い動き)が現れた場合、簡単な回避行を追加する
  • 短いプロンプトはより創造的、長いプロンプトはより制御的
  • ダイアログは専用ブロックに配置し、4-8秒のクリップではセリフを短く保つ
  • リミックスでは不変条件を明示的に述べる(同じショット、同じカメラムーブ)
  • 連続性を保つために、単一変更のフォローアップで反復する

アセットタイプ別ガイダンス

特定の成果物のリクエストがある場合は、これらのモジュールを使用します。対象に特化したテンプレートとデフォルトを提供します。

  • 映画的なショット: references/cinematic-shots.md
  • ソーシャル広告: references/social-ads.md

CLI + 環境に関する注意

  • CLIコマンドと例: references/cli.md
  • APIパラメータクイックリファレンス: references/video-api.md
  • プロンプトガイダンス: references/prompting.md
  • サンプルプロンプト: references/sample-prompts.md
  • トラブルシューティング: references/troubleshooting.md
  • ネットワーク/サンドボックスのヒント: references/codex-network.md

リファレンスマップ

  • references/cli.md: scripts/sora.pyを使用したcreate/poll/remix/download/batchの実行方法
  • references/video-api.md: APIレベルの設定項目(モデル、サイズ、長さ、バリエーション、ステータス)
  • references/prompting.md: プロンプト構造と反復ガイダンス
  • references/sample-prompts.md: コピー&ペーストで使えるプロンプトレシピ(例のみ、追加理論なし)
  • references/cinematic-shots.md: 映画的なショットのテンプレート
  • references/social-ads.md: 短いソーシャル広告ビートのテンプレート
  • references/troubleshooting.md: 一般的なエラーと修正方法
  • references/codex-network.md: ネットワーク/承認に関するトラブルシューティング

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

関連スキル