pireel

Pireel Studio

Pireel Studio (https://pireel.com) は、1つのプロジェクトから個別に編集できる複数のカットを作成できる、複数ソース・複数トラック対応の動画エディターです。ツールは pireel MCP サーバーを介して、ユーザーが開いている Studio のブラウザータブ上でリアルタイムにコンポジションを編集します。タブが開いていない場合、データレベルのツールはユーザーの最新プロジェクトに対してオフラインモードに切り替わります。

このスキルで製品全体を扱います。以下の基本事項に目を通したら、作業内容に合った references/ 内のファイルを開いてください。専門的なフローは記憶に頼って作業しないでください。

基本事項（すべてに共通）

• 編集対象。 型付きトラック上のクリップです。メインの映像ストーリーライン（role=primary）、並行する B ロール／ピクチャーインピクチャー（role=broll）、グラフィックレーン、ナレーション／音楽／効果音のオーディオレーン、管理対象のキャプショントラックがあります。クリップの種類は、ナラティブ（ストーリーを語る映像）、メディア（任意のレーン上の動画または画像）、グラフィック（コンポーネント。現在、モーショングラフィックスが主なコンポーネントファミリーです）、オーディオ、テキスト（set_texts で設定するネイティブタイトル）です。すべてのクリップはタイムライン上の整数フレーム [start, end) を占め、ソース固有の時間を秒単位で保持します。メディアクリップには、フレーミング（full／punch-in／corner-*／split-* の処理、または set_clip_framing による正確な変換／クロップ）、速度、カラーフィルター、オーディオ処理（set_clip_properties）が設定されています。ストーリーライン上のクリップ間は、デフォルトではハードカットです。時間、場所、章、モードの変化に効果がある場合は、add_transition でトランジションを追加します。
• 音声の編集は編集面の1つであり、入り口ではありません。 映像に音声が含まれる場合は、get_transcript と remove_words を使ってトランスクリプトから編集します（フレーム単位では編集しません）。音声がない場合（B ロール、製品映像、画面録画、音楽主体のモンタージュ）は、同じクリップツール（add_clips／insert_clips／split_clips／move_clips／ripple_delete_ranges／set_clip_properties／set_clip_framing／add_clips {role:"music"}）で時間、映像、音声を使って編集します。音声のない映像を編集する前に、スクリプトやトランスクリプトを求めないでください。get_transcript が対象範囲なしと報告するのは情報であり、エラーではありません。
• セッションごとに get_state を1回呼び出し、その後は差分からパッチを適用します。 すべての変更操作は差分（変更されたクリップ、シフトしたルール、removedClipIds、removedSource、キャプションの変更）を返します。変更操作の失敗後、出力／プロジェクトの切り替え後、取り消し後、またはレシートの注記で状態が古いと示された場合に限り、get_state を再読み込みしてください。クリップ／トラック／コンポーネント／フレーム／プリセットの ID は、get_state、ツールのレシート、manage_frame {action:"list"}、またはキャプションカタログから取得します。ID を推測してはいけません。
• 2つの時間軸。 「編集済み」はタイムラインのフレームです（startFrame／atFrame／fromFrame／toFrame／durationFrames。add_clips、split_clips、ripple_delete_ranges、move_clips、apply_component はこれを指定します。get_state が fps を返し、各ツールが変換するため、自分で fps を掛けてはいけません）。「src」はクリップ自身のソースファイルの秒数です（ソースは [inSec, outSec]。トランスクリプトはソース固有の時間軸にタイムスタンプが付き、タイムラインをカットしても移動しません）。混同しないでください。
• BYO 生成は無料です。 自分で作成するテキスト／マークアップ（コンポーネントの構成、作業コンテキストに保持する計画、視覚的なラベル）は、ユーザー自身のエージェントサブスクリプションで実行され、Pireel のクレジットは消費しません。クレジットが請求されるのは、説明に […CHARGES…] マーカーが付いたツールだけです（画像／動画／音声／音声合成の生成、および apply_component {generate:true} などの Pireel-LLM フォールバック）。BYO の方法を優先してください。
• 実際の作業では、早い段階でエディターを表示します。 create_browser_handoff を呼び出し、返された url を自分専用の組み込み／埋め込みブラウザーツールで開いてください。Codex では、接続済みの Chrome ではなく、アプリ内の Browser ランタイムを使用します。OS の open／start／xdg-open、ユーザーのデフォルトブラウザー、またはすでに接続されている外部 Chrome を先回りして使用してはいけません（チケットは1回限りで、有効期間は約60秒です）。そのタブを表示したまま開いておき、ターン終了後も維持できるように keep／finalize コントロールを使ってください（詳細は references/pireel-basics.md を参照）。ハンドオフ URL を出力してはいけません。

ルーティング — タスクに応じてリファレンスを参照してください

ユーザーの目的	参照先
Pireel をインストール／接続／セットアップする、またはツールから未接続と報告される	references/getting-started.md
モデルとツールのルーティングを詳しく理解する（最初の編集前に読んでください）	references/pireel-basics.md
アカウントのプライベート／コミュニティ Studio Skill、またはそれに紐づく音声を使用する	references/pireel-basics.md
ローカルの動画または画像ファイルを使用する	references/asset-import.md
音声主体の動画（インタビュー、レッスン、解説、ポッドキャスト、カメラに向かって話す形式）を最初から最後まで編集する：不要部分の整理、再構成、B-roll、グラフィック、サウンド	references/craft/talking-head-edit.md
生のトーキングヘッドのAロールのみを整理する（撮り直し、フィラー、無音部分）	references/talking-head-cleanup.md
素材映像からモンタージュを構成する（感情、モチーフ、リズム、サウンド）	references/craft/montage-edit.md、次に出力の種類／バリエーションについて references/montage-variants.md
複数のクリップを組み合わせて商品広告を作成する、または編集可能な出力／バリエーションを複数作成する	references/montage-variants.md
音声のない映像（B-roll、商品撮影、画面収録、音楽主体の素材）を編集する	references/pireel-basics.md（クリップツール）→ 意図的に構成するには references/craft/montage-edit.md
BGM、効果音、クリップごとのサウンド、トランジション、またはビートに合わせたカットを追加／調整する	references/craft/audio-and-music.md
デザインされたグラフィック要素（BYO マークアップ）を追加する	references/compose-blocks.md
完成形の初稿／完成動画を設計または作成する	references/storyboard-draft.md
キャプションを追加／スタイル変更する	references/captions.md
MP4 をエクスポートする	references/export.md
料金／クレジット／プラン／UI に関する質問に答える	references/product-help.md
ツールエラー、タイムアウト、または apply_component のリンターによる拒否から復旧する	references/known-errors.md

references/craft/ には、Pireel に組み込まれたクラフトスキルがそのまま収録されています。Studio チャットが使用するプレイブックと同じもので、list_skills／read_skill が MCP 経由で提供します。ローカルコピーを読んでください（通信の往復は不要です）。MCP サーバーが、インストール済みの VERSION と異なるワークフローの基準バージョンを通知した場合は、最新のテキストを得るために read_skill を優先してください。

ローカルメディアのインポートヘルパーは scripts/import-media.mjs にあります（Node ≥ 20、依存関係ゼロ）。

リファレンスの場所。 上記のすべてのパス（references/…、scripts/…）は、このスキル自身のディレクトリ、つまりこの SKILL.md を含むフォルダーからの相対パスです。エージェントからスキルのディレクトリを受け取った場合は、そのまま参照してください。受け取っていない場合は、このスキルの場所を一度特定して、そこからパスを解決してください。例：find ~ -path '*/skills/pireel/SKILL.md' 2>/dev/null（Codex／Claude Code はスキルをディスク上の通常ファイルとしてインストールします）。リファレンスはこのファイルのすぐ隣の references/ にあり、料金／UI のサブドキュメントは references/product-help/ にあります。

課金

エージェントのオーケストレーションと BYO フローはすべて、Pireel のクレジットではなく、ユーザー自身のエージェントサブスクリプションで実行されます。Pireel が課金するのは、メディア生成（画像／動画）と音声／ビジョンのパイプライン（文字起こし、視覚分析）のみです。詳細は references/product-help.md を参照してください。

このワークフローを最新の状態に保つ

Plugin バンドルはホストによって更新されます。該当する場合は何もしないでください。ホストが Plugin の識別情報を報告する場合、またはこの SKILL.md の2つ上のディレクトリにプラグインマニフェストがある場合は、該当します。

それ以外の場合、サーバーがワークフローの基準バージョンを通知し、この SKILL.md の隣にある VERSION ファイルがあなたのバージョンです。どちらも不透明なリリースタグです。順序ではなく、一致するかどうかだけを比較してください。異なる場合は、ホストの通常のコマンド承認フローを通じて npx skills update pireel（代替手段：npx skills add pireel/pireel-agent）を実行し、更新されたファイルをもう一度読み込んでください。1回試した後、または仕組みが利用できない場合や VERSION がない場合は、その旨を一度だけ伝えて続行してください。一致している場合は、繰り返し通知しないでください。