/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 this. Make it feel like a ridiculous startup launch.
これらのオプションを解析します：
| オプション | 値 | デフォルト |
|---|---|---|
--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 キューを含む、ビートごとのストーリーボードを作成します。
音楽が選択された場合、コンパクトな 音楽キューガイダンス セクションを含めます：バンドルされたトラックのキュープリセットが <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秒安定、文は単語あたり約0.3秒）。高速で表示し、その後保持 — 高速で表示してすぐに消えることは避けてください。
具体的に。 ビデオは、任意のプロジェクトではなく、この正確なプロジェクトのために作られたと感じさせる必要があります。
モノを見せる。 少なくとも1つのシーンは、実際のUI、コピー、または製品からの重要なビジュアルを表示しなければなりません。抽象的な埋め草は禁止です。
一般的なSaaS用語は禁止。 「ワークフローを効率化」は禁止です。プロジェクトの実際のコピーと主張を使用してください。
フックがすべて。 最初の2秒で、誰かが見続けるかどうかが決まります。他の何よりも先にフックを計画してください。
面白さはその地位を勝ち取る。 ユーモアは、面白くしようとすることからではなく、プロジェクトの不条理さから生まれるべきです。
パターン：
フック（2-3秒） → リビール（2-4秒） → 2-3の鋭いハイライト（5-12秒） → パンチライン / アウトロ（2-4秒）
これを適応させてください。すべてのプロジェクトが正確に3つのハイライトを必要とするわけではありません。このパターンは開始形状であり、テンプレートではありません。
利用可能なコネクタ
復元された指示に従う前に、muse.connector_search を使用して現在のコネクタドキュメントを見つけてください。