Communitygithub.com

Hasnan42/Showfolio

現在の Octacer プロジェクトを、洗練された Octacer ブランドのショーケース動画(約40、60、90秒)に変換します。プロジェクトの実際の画面はそのままに、その周り(イントロ、タイトル、背景、アウトロ、アニメーションロゴ)を Octacer ブランディングで包み込みます。

Showfolio とは?

Showfolio (Showfolio) は、AI エージェント(Claude Code 等)と連携し、現在の Web アプリケーションやプロジェクトを、Octacer ブランドのプロモーションビデオへと変換するスキルです。利用者は「/showfolio」と指示するだけで、動画の長さ、紹介したい機能、プロジェクトの目的を質問され、その情報をもとにエージェントがプロジェクトコードを直接解析し、ハイパーフレームを用いた動画を生成します。動画内ではプロジェクトの実際の画面がそのまま表示され、Octacer のブランド要素(ロゴ、カラー、フォント)で装飾されます。このスキルは、開発者が自分の作品を簡単に、かつプロフェッショナルに共有したい場合に役立ちます。対応プラットフォームは主に Claude Code を想定していますが、他のエージェントでも利用可能です。動作の核となるのは、ユーザーへの質問による情報収集、プロジェクトコードの検査、動画の計画とストーリーボード作成、そして Hyperframes へのハンドオフという一連のワークフローです。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hasnan42/Showfolio/tree/HEAD/skills/showfolio

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

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

ドキュメント

/showfolio

作ったものは、見せよう。

起動ディスパッチ(最初に必ず実行)

モデルチェック。 あなたが Claude Opus 5.5 であり、かつ呼び出しが完全なワークフロー(--full、"use the full showfolio")やナレーション(--voice、showfolio-slim では対応していない)を要求しない場合、showfolio-slim に切り替えてください。<skill-dir>/slim.md(ここにバンドルされている /showfolio-slim スキル)を読み、このファイルの代わりにそれに従って以降の処理を進めてください。ユーザーの入力をそのまま渡し、その他のオプション(--no-music、--title、…)は平易な言葉による指示として渡してください。最初に「あなたは Opus 5.5 を使用しているので、/showfolio-slim を使用します:動画全体を私が構築します。元に戻すには 'use the full showfolio' と言ってください」などと一行でユーザーに伝えてください。他のモデルの場合、または自分のモデルがわからない場合は、このチェックをスキップしてください。

プロジェクトを調査する前に、完全な /showfolio 呼び出しを解析してください。呼び出しに --voice が含まれている場合、voice.enabled = true を設定してください。その実行でのみナレーションを有効にしてください。ナレーションを自動的に有効にしたり、通常のナレーションなしのワークフローにフォールバックしたりしないでください。

/showfolio は、現在のプロジェクトのウェブサイトやアプリを、Octacer によって構築されたプロジェクトとして提示される、洗練された共有可能なショーケース動画に Hyperframes を使って変換します。これは、狭く、こだわりがあり、楽しいものです。

Octacer ブランディングは常にオンです。 プロジェクト自身の画面はそのまま表示され、その周りのフレーム(アニメーションロゴのイントロ、タイトル、背景、ラベル、コーナーロゴ、アウトロ)は Octacer です。ルールとアセットは次の場所にあります:references/brand.md および <skill-dir>/assets/brand/。

このスキルの機能

  1. ユーザーに3つの質問(長さ、何を紹介するか、目的)をし、アプリがログインを必要とする場合はテスト認証情報を取得します。
  2. 現在のプロジェクトコードを読み取ってアプリを理解します。
  3. このプロジェクトに特化したショーケースのコンセプトを計画します。
  4. Octacer ブランドのフレーム内で動画のスクリプトとストーリーボードを作成します。
  5. 焦点を絞った構成指示書を Hyperframes に渡します。
  6. 検証、レンダリング、共有用のテキストを作成します。

呼び出しの解析

ユーザーは自然言語またはフラグを使用して呼び出すことができます:

/showfolio
/showfolio --duration 60
/showfolio --tone polished --format vertical
/showfolio this. Make it feel like a premium product film.

以下のオプションを解析します:

オプション値デフォルト
--toneプリセットまたは自由形式の説明推測
--formatlandscape、vertical、squarelandscape
--duration秒(約40、60、90)ステップ0で質問
--no-musicフラグ音楽オン
--no-sfxフラグSFXオン
--title文字列プロジェクトから推測
--voiceフラグナレーションオフ

ボイスはオプトインです。--voice が指定された場合、Hyperframes 経由で Kokoro を使用し、プロバイダー選択ロジックを追加しないでください。ボイスワークフローは意図的に単一プロバイダーです。

トーンはプリセット(default、polished、yc-parody、chaotic、deadpan、cinematic、app-store)または「2016年風のフェイクシリーズAローンチ」「博物館の展示品」「過剰に作り込まれたモバイルゲーム広告」などのクリエイティブな方向性を指定できます。

ユーザーが自由形式のトーン指示を与えた場合、ペースと構造については最も近いプリセットにマッピングしますが、計画と構成指示書ではユーザーの指示をそのまま保持します。

ナレーションガイダンス

--voice が有効な場合、視覚を補完し、表示されているテキストを単に読み上げるのではなく、シーンのペースに合い、自然で会話的な響きで、シーン間をスムーズに移行するナレーションを書いてください。スクリプトを簡潔かつプロダクトに特化したものにし、ボイスが別のナレーショントラックではなく、編集の一部であるように感じさせてください。


出力ディレクトリ

デフォルトでは、出力は showfolio-output/ に出力されます。以前の実行を上書きしないように、タイムスタンプ付きのディレクトリを使用します:

showfolio-output-2026-05-04-143022/

次の場合にタイムスタンプを使用します:

  • ユーザーが以前の結果を上書きせずに新しい実行を明示的に要求した場合
  • プロジェクトに showfolio-output/ ディレクトリが既に存在する場合

実行の開始時にタイムスタンプ(YYYY-MM-DD-HHmmss)を生成し、その実行のすべての出力パス(計画、指示書、構成、レンダリング、共有コピー)で一貫して使用します。

スキルディレクトリ

<skill-dir> はこの SKILL.md を含むディレクトリです。Claude Code はスキルがロードされるときに「このスキルのベースディレクトリ」としてそれを出力します。他のエージェントの場合、それはスキルがインストールされた場所になります。バンドルされたアセットは <skill-dir>/assets/ にあり、スクリプトは <skill-dir>/scripts/ にあります。インストールパスを推測しないでください。プラグインインストール、~/.claude/skills/ へのコピー、およびこのリポジトリはすべて異なる場所に配置されます。


ステップ0:情報収集

参照: references/step-0-intake.md

ユーザーに3つの質問(動画の長さ、紹介する機能/ページ、一言の目的)を1つのメッセージで尋ね、回答を待ってください。次にログインチェックを実行します。表示する部分がログインの背後にある場合は、ユーザーから提供された認証情報を使用し、そうでない場合はリポジトリ内のテスト認証情報を探し、それもなければユーザーに認証情報を尋ねてください。

ゲート: 目標の長さ、必ず表示するリスト(ユーザーがお気に入りとしてマークしたものを含む)、および一言の目的が決まっていること。アプリがログインを必要とする場合、有効なテスト認証情報があるか、ユーザーが認証情報なしで進めることに同意していること。


ステップ1:プロジェクトの調査

参照: references/step-1-inspect.md

プロジェクトディレクトリをスキャンし、動画の計画に必要な情報を抽出します。特に、ステップ0でユーザーが選択した機能とページに注意を払ってください。

ゲート: 計画ルーブリックの9つの質問すべてに回答できること。


ステップ2:計画とストーリーボード

参照: references/step-2-plan.md 参照: references/brand.md

<output-dir>/showfolio-plan.md(<output-dir> は上で選択した showfolio-output/ またはタイムスタンプ付きのバリアント)を書きます。計画ルーブリックに回答します。クリエイティブな方向性を決定します。ビートごとのストーリーボードを、シーン、テキスト、タイミング、トランジション、SFXキューを含めて書きます。

音楽が選択されている場合、コンパクトな「音楽キューガイダンス」セクションを含めます。バンドルされたトラックのキュープリセットが <skill-dir>/assets/music/cues/ にあればそれを読み、そうでなければキューは構成時に検出されることに注意してください(どのトラックもビート同期をサポートしています — references/audio.md を参照)。キューに関するメタデータはオプションのタイミングガイダンスに過ぎません。ストーリー、可読性、ペース、プロダクトの明確さが最優先されます。

ゲート: <output-dir>/showfolio-plan.md が完全なストーリーボードとともに存在すること。ステップ0からのすべての必ず表示するアイテムにシーンがあること。シーン時間の合計がステップ0からの目標時間に対して±10%以内であること。


ステップ3:Hyperframes へのハンドオフ

参照: Hyperframes のドメインスキル — hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-keyframes、hyperframes-cli。/showfolio は独自のワークフローです。hyperframes エントリポイントのインテントインタビューに入ったり、その汎用プロモーション/ローンチビデオワークフローにルーティングしたりしないでください。 参照: references/step-3-compose.md 参照: references/audio.md 参照: references/brand.md

<skill-dir>/assets/brand/ を構成のアセットにコピーします。構成指示書を書き、Hyperframes を使用して <output-dir>/composition/ に動画実装を作成します。

/showfolio は、プロダクトの角度、ソースマテリアル、ストーリーボード、トーン、フォーマット、オーディオ選択、音楽キューガイダンス、および配送の期待値を所有します。Hyperframes は、具体的な構成構造、正確なアニメーションタイミング、アニメーションメカニクス、ランタイムの選択、リンティングルール、およびレンダリングワークフローを所有します。

ゲート: npx hyperframes check が <output-dir>/composition/ 内でエラーゼロでパスすること(レンダリング前のシングルブラウザゲート — hyperframes-cli が何を監査するかを参照してください)。


ステップ4:検証、レンダリング、提供

参照: references/step-4-deliver.md

検証、プレビュー、<output-dir>/showfolio.mp4 へのレンダリング、最適なポスターフレームを <output-dir>/showfolio.jpg に選択し、そのポスターを動画のフレーム0として焼き付けてアイドルサムネイルにし、<output-dir>/share-copy.txt を書きます。

ゲート: <output-dir>/showfolio.mp4 が存在すること。最適なフレームのポスター <output-dir>/showfolio.jpg が選択され(任意のフレームではない)、showfolio.mp4 のフレーム0として焼き付けられていること。共有コピーが書かれていること。出力ファイルやフレームに認証情報が含まれていないこと。


トーンシステム

/showfolio には7つのトーンプリセットが付属しています。それぞれが、スクリプトのエネルギー、ペース、タイポグラフィの個性、トランジションスタイルを変更します。プリセットはデフォルトであり、制限ではありません。

完全な定義:references/tones.md

トーンエネルギー一言
default遊び心があり、クリーン、投稿可能良い雰囲気のデフォルト
polishedシリアスでエレガントジョークではないプロジェクト向け
yc-parody無表情なスタートアップのエネルギー不条理なプロジェクトに適用される偽の真剣さ
chaotic速く、うるさく、攻撃的過激で奔放
deadpan穏やかで、ドライ、控えめ何もジョークではないことがジョーク
cinematicドラマチックで、トレーラースケール大きな動き、さらに大きな主張
app-storeスムーズで、フィーチャーカードのようにクリーンコーポレートだが退屈ではない

常に自由形式のクリエイティブな方向性を許容し、プリセットを洗練またはオーバーライドできるようにします。


クリエイティブロー

これらは、トーンに関係なく、すべてのショーフォリオ動画に適用されます。

Octacer フレーム、実際のプロダクト。 プロダクトの画面はそのまま表示されます。それらの周りのすべては、Octacer ブランド(インク #040408、ホワイト、ライム #A3DC2F がシグナルカラー;Space Grotesk、Montserrat、JetBrains Mono;ロゴ SVG、タイプは不可)を使用します。アニメーションする Octacer ロゴで開始し、「Built by Octacer」で終了します。references/brand.md を参照してください。

ユーザーが求めた長さ。 ステップ0の目標(約40、60、または90秒)を±10%以内で達成します。時間を埋めるにはプロダクトを使用し、詰め物は使用しません。つまり、より多くの機能とより長い動作中のアプリの瞬間を使い、何もないところで長くホールドすることはしません。これはナレーションの有無にかかわらず適用されます。ナレーションによって時間枠が延長されることはありません。

彼らが求めたものを紹介する。 ステップ0でユーザーが指定したすべてのページまたは機能には、独自のシーンがあります。彼らがお気に入りとしてマークしたものには、最も多くの画面時間と最も強力な配置が与えられます。

生き生きと、速く。 60fps、0.5〜0.8秒のスナッピーなカメラ移動、ゆっくりとしたドリフトはなし、2〜3秒ごとに新しい何か、ほとんどのプロダクトシーンでカーソルがクリックされ、すべてのチャットまたは入力ボックスでリアルタイムのタイピングが行われます。完全な数値:references/step-2-plan.md の「モーションとペースのルール」。

読みやすい。 モーションとカットによってペースを高く保ち、テキストをフラッシュさせることは決してしないでください。視聴者が読まなければならない各行は、それを読むのに十分な時間保持されます(短いラベルは約0.8秒間静止;文は1単語あたり約0.3秒)。速く入って、その後ホールド — 決して速く入って、その後消えないでください。

具体的に。 動画は、任意のプロジェクトではなく、この正確なプロジェクトのために作られたように感じさせる必要があります。ユーザーの一言の目的がストーリーの背骨です。

モノを見せる。 ほとんどのシーンは、実際のUI、コピー、またはプロダクトからの重要なビジュアルを表示します。抽象的な詰め物はありません。

汎用的なSaaS用語はなし。 「ワークフローを合理化する」は禁止です。プロジェクトの実際のコピーと主張を使用してください。

フックがすべて。 最初の2秒が、誰かが見続けるかどうかを決定します。他の何よりも先にフックを計画してください。

面白さはそれにふさわしい位置を占める。 ユーモアは、面白くしようとすることからではなく、プロジェクトの不条理さから生まれるべきです。

パターン:

Octacer スティング (1.5-2.5秒) → フック (3-5秒) → 目的/公開 (4-8秒) → 必ず表示する機能ごとに1セグメント (各6-15秒;お気に入りが最長) → Octacer ロゴ付きアウトロ (3-5秒)

これを適応させてください。機能セグメントのサイズを調整して、合計が目標に達するようにします。パターンは開始時の形状であり、テンプレートではありません。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル