プリアンブル(最初に実行)
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
_TEL_TIER="${_TEL_TIER:-anonymous}"
_TEL_PROMPTED=$([ -f ~/.superstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
mkdir -p ~/.superstack
echo "TELEMETRY: $_TEL_TIER"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
if [ "$_TEL_TIER" != "off" ]; then
_TEL_EVENT='{"skill":"video-craft","phase":"launch","event":"started","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'
echo "$_TEL_EVENT" >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
_CONVEX_URL=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"convexUrl":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "")
[ -n "$_CONVEX_URL" ] && curl -s -X POST "$_CONVEX_URL/api/mutation" -H "Content-Type: application/json" -d '{"path":"telemetry:track","args":{"skill":"video-craft","phase":"launch","status":"success","version":"0.2.0","platform":"'$(uname -s)-$(uname -m)'","timestamp":'$(date +%s)000'}}' >/dev/null 2>&1 &
true
fi
TEL_PROMPTED が no の場合:スキルワークフローを開始する前に、ユーザーにテレメトリについて尋ねてください。オプション:A) はい(匿名) B) いいえ、結構です。これは一度だけ行われます。
スキルが間違っていますか? 利用可能なすべてのスキルについては SKILL_ROUTER.md を参照してください。
ビデオクラフト
Remotion 動画のフレームレベルビジュアルコンポジションとプロダクトデモプレゼンテーション。このスキルは、単に正しくアニメーション化されているだけでなく、各フレームが意図的にデザインされているように見せます。
marketing-video は制作パイプライン(インタビュー、ストーリーテリング、アニメーション機構、レンダリング)を処理します。このスキルは各静的フレームの見た目 — コンポジション、デバイスフレーミング、背景、エフェクトの選択、エンドカードデザイン — を扱います。
権限モデル
marketing-video→ 制作パイプライン、アニメーション機構、ベースライン品質(タイプ最小値、セーフゾーン、スプリング物理)design-taste→ 美的方向性。このスキルはそれを消費し、再定義しません。- このスキル → 時間制限のある視聴のためのフレームコンポジション、プロダクトデモプレゼンテーション、エンドカードデザイン、エフェクトファミリー
継承(再定義しない): marketing-video からのタイプ最小値、モバイルセーフゾーン、テキストの可読性、スプリングデフォルト。design-taste からの色の抑制、非対称性、余白。
起動条件
- Remotion コンポジションのビジュアル品質をレビューする
- スクリーンショットを使用したプロダクトデモ動画を構築する
- エンドカード / CTA フレームをデザインする
- ユーザーが「動画のフレームが汎用的に見える」「もっと洗練された感じにして」と言う
marketing-videoがクリエイティブディレクションまたはビルドフェーズ中にこのスキルを呼び出す
「動画を作成」や「マーケティング動画」では起動しないでください — それらは marketing-video にルーティングされます。
ワークフロー
design-tasteで美的方向性を確認する(またはユーザーに選択してもらう)- 該当するリファレンスを特定する:
- 動画フレームまたはエンドカードのコンポジション → references/frame-composition.md
- プロダクトデモシーンの構築 → references/product-demo-patterns.md
- シーンごとにフレームブリーフを作成する
- レンダリング前にプリフライトチェックリストを実行する
フレームブリーフ(シーンごと)
Scene: [名前]
Duration: [秒 / フレーム数]
Aspect: [16:9 / 9:16 / 1:1]
Focal point: [最初に目が留まる場所]
Archetype: [hero / product / split / data / comparison / end-card]
Device: [laptop / phone / browser / none]
Assets needed: [スクリーンショットのパス、ロゴ、アイコン名]
Background: [radial gradient + noise / screenshot blur / mesh / solid]
Effect family: [glow / kinetic / liquid / audio-lock / depth / none]
Animation: [入りスプリング設定、ホールドフレーム、退出]
プリフライトチェックリスト
- すべてのフレームに明確な焦点が1つある
- スクリーンショットはデバイスフレーム内にあり、浮いた生データではない
- 背景には奥行きがある(グラデーション + ノイズ、またはビネット)、フラットな単色ではない
- 画面上のテキストブロックは最大8単語
- テキストフレームのホールド時間 >=
(単語数 x 0.3) + 1秒 - エンドカードは最低3秒、アクションは1つだけ
- エフェクトファミリーは動画全体で1〜2つに制限
- フレーム作業の前に美的方向性を選択済み
リソース
references/
- references/frame-composition.md — フレームアーキタイプ(16:9 および 9:16)、時間制限のある可読性、背景の奥行き、エフェクトファミリー、エンドカードアーキタイプ(clean/metric/action/loop)
- references/product-demo-patterns.md — Remotion 対応:デバイスフレーム(ラップトップ/電話/ブラウザ)、カーソルコレオグラフィ、ズームレシピ、スクリーンショット準備、注釈パターン
スキル間リファレンス
marketing-video— 制作パイプライン、アニメーション機構、ベースライン品質ルールdesign-taste— フレーム作業の前に消費する美的方向性number-formatting— フレーム内に表示されるメトリクス用
テレメトリ(最後に実行)
_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - ${_TEL_START:-$_TEL_END} ))
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
if [ "$_TEL_TIER" != "off" ]; then
echo '{"skill":"video-craft","phase":"launch","event":"completed","outcome":"OUTCOME","duration_s":"'$_TEL_DUR'","session":"'$_SESSION_ID'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","platform":"'$(uname -s)-$(uname -m)'"}' >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
true
fi
OUTCOME はワークフローの結果に応じて success/error/abort に置き換えてください。