/brag
作ったなら、自慢しよう。
呼び出しディスパッチ（最初に必ず実行）
モデルチェック。 あなたがClaude Opus 5.5で、呼び出しが完全ワークフロー（--full、「use the full brag」）またはナレーション（--voice、brag-slimは非対応）を要求していない場合、brag-slimに切り替えます：<skill-dir>/slim.md（ここにバンドルされている/brag-slimスキル）を読み、このファイルの代わりにそれに従って以降の処理を行います。ユーザーの入力を引き継ぎ、他のオプション（--no-music、--title、…）を平易な指示として渡します。最初にユーザーに1行で伝えます。例：「あなたはOpus 5.5を使用しているので、/brag-slimを使用します：私がビデオ全体を自分で構築します。切り替えるには 'use the full brag' と言ってください。」他のモデルの場合、または自分がどのモデルか判断できない場合は、このチェックをスキップします。
プロジェクトを調査する前に、完全な/brag呼び出しを解析します。呼び出しに--voiceが含まれている場合、voice.enabled = trueに設定します。その実行のみナレーションを有効にします。ナレーションを自動的に有効にしたり、通常の音声なしワークフローにフォールバックしたりしないでください。
/bragは、現在のプロジェクトのウェブサイトやアプリを、Hyperframesを使用した短く洗練された共有可能なローンチビデオに変換します。これは、狭く、独創的で、楽しいものです。
このスキルの機能
- 現在のプロジェクトのコードを読み、アプリを理解します。
- このプロジェクトに特化した短いブラッグコンセプトを計画します。
- ビデオのスクリプトとストーリーボードを作成します。
- 焦点を絞ったコンポジション概要をHyperframesに渡します。
- 検証、レンダリング、共有コピーの作成を行います。
呼び出しの解析
ユーザーは自然言語またはフラグで呼び出すことができます：
/brag
/brag --tone chaotic
/brag --tone polished --format vertical
/brag これをやれ。馬鹿げたスタートアップのローンチみたいにしろ。
以下のオプションを解析します：
| オプション | 値 | デフォルト |
|---|---|---|
--tone | プリセットまたは自由形式の説明 | 推測 |
--format | landscape、vertical、square | landscape |
--duration | 秒数 | 自動（15～25秒） |
--no-music | フラグ | 音楽オン |
--no-sfx | フラグ | SFXオン |
--title | 文字列 | プロジェクトから推測 |
--voice | フラグ | ナレーションオフ |
音声はオプトインです。--voiceが存在する場合、Hyperframes経由でKokoroを使用し、プロバイダー選択ロジックは追加しないでください。音声ワークフローは意図的に単一プロバイダーです。
トーンはプリセット（default、polished、yc-parody、chaotic、deadpan、cinematic、app-store）または「2016年の偽シリーズAローンチ」、「博物館の展示品」、「過剰に制作されたモバイルゲーム広告」などのクリエイティブな方向性にすることができます。
ユーザーが自由形式のトーン指示を出した場合、テンポと構造に関しては最も近いプリセットにマッピングしますが、計画とコンポジション概要ではユーザーの指示を保持します。
ナレーションガイダンス
--voiceが有効な場合、ビジュアルを補完し、表示されているテキストを単に読むのではなく、シーンのテンポに合い、自然で会話的に聞こえ、シーン間をスムーズに移行するナレーションを書きます。スクリプトは簡潔で製品に特化したものにし、声が別のナレーショントラックではなく編集の一部であるかのように感じさせます。
出力ディレクトリ
デフォルトでは、出力はbrag-output/に出力されます。以前の実行を上書きしないように、タイムスタンプ付きのディレクトリを使用します：
brag-output-2026-05-04-143022/
以下の場合にタイムスタンプを使用します：
- ユーザーが以前の結果を上書きせずに新しい実行を明示的に要求した場合
brag-output/ディレクトリがプロジェクトに既に存在する場合
実行の開始時にタイムスタンプを生成し（YYYY-MM-DD-HHmmss）、その実行のすべての出力パス（計画、概要、コンポジション、レンダリング、共有コピー）で一貫して使用します。
スキルディレクトリ
<skill-dir>は、このSKILL.mdを含むディレクトリです。Claude Codeはスキル読み込み時に「このスキルのベースディレクトリ」として表示します。他のエージェントにとっては、スキルがインストールされた場所です。バンドルされたアセットは<skill-dir>/assets/に、スクリプトは<skill-dir>/scripts/にあります。インストールパスを推測しないでください。プラグインインストール、~/.claude/skills/へのコピー、このリポジトリはすべて異なる場所に配置されます。
ステップ1：プロジェクトの調査
参照： references/step-1-inspect.md
プロジェクトディレクトリをスキャンし、ブラッグビデオの計画に必要な情報を抽出します。
ゲート： ブラッグ計画ルーブリックの9つの質問すべてに回答できること。
ステップ2：計画とストーリーボード
<output-dir>/brag-plan.mdを作成します（<output-dir>はbrag-output/または上記で選択したタイムスタンプ付きのバリエーション）。計画ルーブリックに回答します。クリエイティブなアングルを決定します。ビートごとのストーリーボード（シーン、テキスト、タイミング、トランジション、SFXキューを含む）を作成します。
音楽が選択されている場合、コンパクトなMusic cue guidanceセクションを含めます：バンドルされたトラックのキュープリセットが<skill-dir>/assets/music/cues/に存在する場合はそれを読み、存在しない場合はコンポジション時にキューが検出されることに注意します（すべてのトラックがビート同期をサポートするようになりました— references/audio.mdを参照）。キューメタデータはオプションのタイミングガイダンスにすぎません。ストーリー、可読性、テンポ、製品の明確さが優先されます。
ゲート： 完全なストーリーボードを含む<output-dir>/brag-plan.mdが存在すること。シーンの合計時間が15～25秒になること。
ステップ3：Hyperframesへの引き継ぎ
参照： Hyperframesのドメインスキール — hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-keyframes、hyperframes-cli。/bragは独自のワークフローです。hyperframesエントリポイントインテントインタビューに入ったり、その汎用プロモーション/ローンチビデオワークフローにルーティングしたりしないでください。
参照： references/step-3-compose.md
参照： references/audio.md
コンポジション概要を作成し、Hyperframesを使用して<output-dir>/composition/にビデオ実装を作成します。
/bragは、製品のアングル、ソースマテリアル、ストーリーボード、トーン、フォーマット、オーディオ選択、音楽キューガイダンス、提供期待値を所有します。Hyperframesは、具体的なコンポジション構造、正確なアニメーションタイミング、アニメーションメカニクス、実行時の選択、リンティングルール、レンダリングワークフローを所有します。
ゲート： <output-dir>/composition/内でnpx hyperframes checkがエラーゼロで合格すること（レンダリング前の唯一のブラウザゲート— hyperframes-cliで何を監査するかを参照）。
ステップ4：検証、レンダリング、提供
参照： references/step-4-deliver.md
検証、プレビュー、<output-dir>/brag.mp4へのレンダリング、最適なポスターフレームを<output-dir>/brag.jpgに選択、そのポスターをビデオのフレーム0として焼き付けてどこでもアイドルサムネイルにし、<output-dir>/share-copy.txtを作成します。
ゲート： <output-dir>/brag.mp4が存在すること。最適フレームのポスター<output-dir>/brag.jpgが選択され（任意のフレームではない）、brag.mp4のフレーム0として焼き付けられていること。共有コピーが作成されていること。
トーンシステム
/bragには7つのトーンプリセットが付属しています。それぞれがスクリプトのエネルギー、テンポ、タイポグラフィの個性、トランジションスタイルを変更します。プリセットはデフォルトであり、制限ではありません。
完全な定義： references/tones.md
| トーン | エネルギー | 一言で言うと |
|---|---|---|
default | 遊び心があり、クリーン、投稿可能 | 良い雰囲気のデフォルト |
polished | シリアス、エレガント | ジョークではないプロジェクト向け |
yc-parody | 無表情なスタートアップのエネルギー | 不条理なプロジェクトに適用される偽の真剣さ |
chaotic | 速い、うるさい、攻撃的 | 大げさで不安定 |
deadpan | 落ち着いている、ドライ、控えめ | 何もジョークではないというジョーク |
cinematic | ドラマチック、トレーラースケール | 大きな動き、さらに大きな主張 |
app-store | スムーズ、機能カードのようにクリーン | 企業的だが退屈ではない |
常に自由形式のクリエイティブな方向性を許可し、プリセットを洗練またはオーバーライドします。
クリエイティブの法則
これらは、トーンに関係なく、すべてのブラッグビデオに適用されます。
短く。 15～25秒。理由なく1秒以上にしてはいけません。
読みやすく。 動きとカットを通じてテンポを高く保ち、テキストをフラッシュ表示させないでください。視聴者が読まなければならないすべての行は、読むのに十分な長さ保持されます（短いラベルは約0.8秒静止、文章は1単語あたり約0.3秒）。速く入れてから静止— 決して速く入れてから消えないでください。
具体的に。 ビデオは、任意のプロジェクトではなく、この正確なプロジェクトのために作られたように感じられなければなりません。
そのものを表示する。 少なくとも1つのシーンで、実際のUI、コピー、または製品の主要なビジュアルを表示する必要があります。抽象的な埋め草は禁止です。
一般的なSaaS用語は禁止。「ワークフローを効率化」は禁止です。プロジェクトの実際のコピーと主張を使用してください。
フックがすべて。 最初の2秒で、誰かが見続けるかどうかが決まります。他の何よりも先にフックを計画してください。
面白さは正当な場合のみ。 ユーモアは、面白くあろうとするのではなく、プロジェクトの不条理さから生まれるべきです。
パターン：
フック（2～3秒） → 開示（2～4秒） → 2～3つの鋭いハイライト（5～12秒） → オチ/アウトロ（2～4秒）
これを適応させてください。すべてのプロジェクトが正確に3つのハイライトを必要とするわけではありません。パターンは開始形状であり、テンプレートではありません。