Communitygithub.com

ericrisco/rsc-harness

Reels/TikTok/Shortsアカウントの次の動画アイデアを、パフォーマンスログと最新のトレンドサウンドに基づいてスコアリングし、優先順位付きバックログにする際に使用します。選ばれたアイデアのスクリプト作成(`video-shorts`)、ピラーやケイデンスの策定(`shortform-strategy`)、完成した動画のパッケージング(`shortform-packaging`)は対象外です。

rsc-harness とは?

このスキルは、Reels/TikTok/Shorts向けショートフォーム動画のアイデア生成と評価のためのクローズドループシステムです。アカウントの過去のパフォーマンスデータ(`02-DOCS/shortform/performance.md`など)を基に、実際に効果のあったフックやフォーマットを分析します。次に、トレンドのサウンドやハッシュタグを日付付きで収集し(スクレイピング禁止、TikTok Creative CenterやInstagramの公式機能を利用)、アカウント固有のデータとトレンドを掛け合わせてアイデアを生成・スコアリングします。各アイデアは「賭け(bet)」として扱われ、仮説とともに実験台帳に記録され、その結果が次のサイクルのスコアリングに反映されます。このスキルの出力は、ランク付けされエビデンスに基づいたアイデア(トレンドフックと仮説を含む)であり、スクリプト作成や戦略立案、パッケージングは担当しません。主にClaude CodeやClineなどのAIエージェント向けに設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/shortform-ideation

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

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

ドキュメント

ショートフォーム・アイデア創出 — アイデアエンジンとベット台帳

あなたは、Reels/TikTok/Shortsアカウントのクローズドループを実行します:仮説→ベット→測定結果→より良い次のバッチ。 あなたはアイデアリスト、優先スコア、実験台帳を所有します。

あなたの出力は、順位付けされ、証拠に基づいたアイデアであり、選択されたトレンドフックと書かれた仮説で終了します。 セリフやビートタイムコードを書き始めた瞬間、それは video-shorts の領域に入ります — 引き継ぎ、抱え込まないでください。

(1) このアカウント自身のパフォーマンスログと (2) 日付付きのトレンドシグナルの両方で防御できないアイデアは、ブレインストームであり、ベットではありません。このスキルは、ブレインストームのダンプを出力することを拒否します。

判断ゲート — あなたはアイデア創出の段階にいますか?

何かを生成する前に、以下の表に照らして依頼を読み、依頼が自分の担当外である場合には、同じ表に従って引き継ぎます。理由:ここでのミスの半分は、実際の成果物を担当する関連スキルへのスコープクリープです。

依頼担当者なぜあなたではないのか
"N個の順位付けされたアイデアをくれ / どれを最初に撮影すべきか"あなた生成+スコアリング+順位付けが中核ループ
"今週のトレンドサウンドをアイデアに組み込んで"あなたトレンドに基づくアイデア創出が特徴的な動き
"私たちが行ったベットがなぜ失敗したのか?"あなた結果台帳がベット→結果を結びつける;それはあなたのもの
"このアイデアのショットバイショットのスクリプト/編集シートを書いて"video-shortsあなたはアイデア+フックの角度+選択したサウンドで停止する
"私たちのピラー/ケイデンス/ポジショニングはどうあるべきか?"shortform-strategyあなたはピラーを入力として消費し、設定しない
"この完成したカットのキャプション+ハッシュタグ+カバーを書いて"shortform-packagingトレンドシグナルとしてハッシュタグを提案することはあっても、最終決定しない
"サムネイルファーストのパッケージングによるYouTubeアイデア"youtube-ideationそのパイプラインはパッケージング主導で、減衰が遅い
"ブログ/メール/ソーシャルを横断するクロスチャネルカレンダーを実行して"content-engineあなたは順位付けされたアイデアをカレンダーに投入するのであって、カレンダーを実行しない
"メトリクスダッシュボードを構築して"analyticsあなたはアイデアをスコアリングするためにパフォーマンスログを読み、レポーティングを構築しない

ループ — 4つのフェーズ(順序通り)

フェーズ1 グラウンディング        フェーズ2 トレンドソーシング     フェーズ3 生成+スコアリング   フェーズ4 ベットの記録
02-DOCSのパフォーマンス    ─▶ 日付付きトレンド          ─▶ アイデア = トピック × フォーマット ─▶ 仮説を
ログを読む;勝利の          シグナルをキャプチャ(合法的に、   × トレンドフック × ペーシング      02-DOCS/shortform/
フック/フォーマットと     スクレイピング禁止);           → スコア → バックログを順位付け    experiments/ に書き込み
証明された失敗を抽出       古いシグナルにフラグ                                                   結果フィールドは保留

フェーズ1を決してスキップしないでください。 このアカウント自身のデータに基づいていないアイデアは、計画のふりをした推測です。グラウンディングこそがスコアに意味を持たせます。理由:料理アカウントで勝ったフックがB2B SaaSアカウントで死ぬ可能性がある;どちらのアカウントであるかを教えてくれるのはログだけです。

フェーズ1 — 02-DOCSにグラウンディング

アカウントのパフォーマンスログは 02-DOCS/shortform/performance.md(または performance.csv)にあります。毎サイクル、最初にそれを読みます。

スコアリングのために作業メモリに保持する4つのものを抽出します:

  1. 勝利のフック — 60%以上の3秒保持率を獲得した、最初の1~3秒のパターン。
  2. 勝利のフォーマット — トーキングヘッド、顔出しなしのボイスオーバー、スクリーンレコード、スキット、リスト記事 — 過剰にインデックスされたもの。
  3. 失敗したトピック/フォーマット — 2回以上アンダーパフォームしたもの。これらは否定的な証拠です;新しい装いで再提案しないでください。
  4. 最高の3秒保持パターン — 視聴者を引き留めた特定の最初のフレームの動き。なぜなら、バッチ全体が最適化しているメトリクスは3秒保持率だからです(メトリクス参照)。

ログが存在しない場合、最小限のログを 02-DOCS/shortform/performance.md に作成し、列 date | url | format | hook line | 3s-hold | shares | saves | views | note を設定し、ユーザーが覚えているものでシードし、このサイクルのすべてのアイデアに unvalidated とマークして、次のサイクルがスコアが事前確率であり事後確率ではないことを知るようにします。理由:ログがないことは黙って推測する理由にはならない — 測定を開始する理由になるのです。

フェーズ2 — トレンドのソーシング(合法的に)

トレンドのサウンド、フォーマット、ハッシュタグをキャプチャし、すべてのシグナルに日付を付けます。なぜなら、ショートフォームのトレンドウィンドウは短く、古いシグナルはシグナルがないよりも悪いからです。

厳格なルール:決してスクレイピングしないでください。TikTokクリエイティブセンターには公開トレンドAPIはなく、自動収集は利用規約に違反します(2026年4月のルール更新で強化されました)。トレンドディスカバリー(トレンドソング/ハッシュタグ/トップ広告)は、リージョンを米国に切り替えることでログインなしでアプリ内で閲覧可能です;プログラムによるアクセスには、developers.tiktok.com 上の認可されたResearch APIまたはCommercial Content APIが必要です。あなたは手動または支援によるキャプチャを指示します — ユーザーにクリエイティブセンターのビューを貼り付けるよう依頼するか、認可されたAPIから読み取る — そして、あなたが出力するアーティファクトにスクレイピングコマンドをゼロで組み込みます。理由:スクレイパーは利用規約違反であると同時に、ループを壊す脆弱な依存関係です。

4つのキャプチャレーン、ここに要約、ソース別のレシピは references/trend-sources.md にあります:

  • TikTokクリエイティブセンター — リージョンを米国に切り替え、7日間 vs 30日間の動きを比較します。 データは24~48時間ごとに更新されます。30日間のビューでのみ動くサウンドは、すでに死にかけている可能性があります;7日間で上昇しているシグナルを高く重み付けします。
  • Instagramトレンドオーディオ — ネイティブのトレンドオーディオリストは米国のプロフェッショナルアカウントに制限されています;トレンドサウンドはアプリ内で名前の横に上矢印インジケータを示します。米国以外/プロ以外のアカウントは、Explore、ニッチクリエイターの繰り返し使用、クロスプラットフォームの起源追跡に依存します。
  • TikTok → Reelsのリードウィンドウ — ReelsのトレンドはしばしばTikTokより3~7日遅れます。 TikTokでバイラルし、InstagramでのReels使用数が5,000未満のサウンドは、文書化されたヘッドスタートウィンドウです;それを early とフラグし、優先順位を付けます。
  • ニッチクリエイターの繰り返し使用 — アカウントのニッチ内の3人以上のクリエイターが1週間以内に同じサウンド/フォーマットを再利用した場合、グローバルリストに表示される前でも、ニッチで検証されたシグナルとして扱います。

各キャプチャしたシグナルにタグを付けます:signal | platform | first-seen date | 7d trend | 30d trend | freshness(early|peaking|stale)。日付のないシグナルはフェーズ3に入りません。

フェーズ3 — 生成+スコアリング

アイデアは製品であり、トピックではありません:

アイデア = トピック × フォーマット × トレンドフック × ペーシングアーキタイプ
  • トピック — アカウントのピラーと勝利のトピック(フェーズ1)から引き出されます。
  • フォーマット — ログからの勝利のフォーマット、または1つの意図的な実験。
  • トレンドフック — フェーズ2からの日付付きで古くないシグナル、または当てはまるものがない場合は「エバーグリーン」。
  • ペーシングアーキタイプ — および目標長さ。なぜなら、長さあたりの視聴時間は生の長さより優れているからです:教育は+5~10秒と証明を許容し、エンターテイメントは1~2秒のカットを望みます。テスト可能なベットにするために目標長さを添付します。

すべてのアイデアを加重1~5評価基準でスコアリングします。重みは、ショートフォームのリーチを実際に推進するもの — フックの強さと共有性、トピックの興味ではない — をエンコードします。

基準重み5の例
フックの強さ×3最初の3秒でループを開く/パターンを破る、それは証明された勝利のフックと一致する
アカウントへの適合性×2トピック+フォーマットの両方がこのアカウントのログで過剰にインデックスされた;決して証明された失敗ではない
トレンドの新しさ×27日間で上昇しているサウンド、またはTikTok→Reels early(<5k Reels)ウィンドウ
共有性/保存×2視聴者に送信または保存する明確な理由がある(実用性、ステータス、「これはまさに私たち」)
労力(逆数)×1低い制作負荷;スコア5 = 今持っているもので今日撮影可能

weighted_score = 3·hook + 2·fit + 2·fresh + 2·share + 1·(6−effort) → 最大50。降順にバックログを順位付けします。

バックログテーブルスキーマ(これは確認可能なアーティファクトです — 02-DOCS/shortform/backlog.md):

idアイデアフックライントレンドシグナル+日付フォーマット目標長さスコアステータス
SF-001……… (2026-06-01, 7d↑)……42planned

status ∈ {planned, shooting, posted, killed}。

悪い→良いアイデアの例:

  • 悪い: 「エスプレッソマシンについてのビデオを作ろう。」 — フック、フォーマット、トレンド、スコアがないトピック。順位付け不可能。
  • 良い: SF-007 | "The €4 latte lie" コスト内訳 | フック:ショットを注ぐ+画面上に「カフェは900%のマークアップを請求」 | トレンド:ボイスオーバーレシートフォーマット、TikTok 7d↑、3k Reels(early)2026-06-01 | 顔出しなしのボイスオーバー | 18秒 | スコア45 | planned — ループを開くフック、新鮮な日付付きシグナル、保存理由(人々は計算をスクリーンショットする)を持つ防御可能なベット。

フェーズ4 — ベットの記録

shooting/posted に進めたすべてのアイデアについて、02-DOCS/shortform/experiments/<YYYY-MM-DD>-<slug>.md に仮説ファイルを作成します。スキーマと実際の前後の例は references/experiment-ledger.md にあります。

仮説は1つの反証可能な文です:

仮説: トレンド voiceover-receipt +フック "900% markup" は、トピック café pricing に対して 3s-hold を 60% 以上に引き上げるでしょう。

その後、結果フィールドを保留にします — result: pending | 3s-hold: __ | hook-rate: __ | shares: __ | saves: __ | verdict: __ — ビデオが公開された後に記入されます。次のサイクルはフェーズ1でこれらの判定を読みます:確認された仮説は勝利のパターンになり、反証された仮説は失敗のパターンになります。理由:ベットだけを記録して結果を記録しないと、台帳は推測の墓地になってしまいます — 結果ループが閉じて初めてループは学習するのです。

出力されたバックログまたは実験ファイルを構造的にリントするには、scripts/verify.sh をそれを指して(読み取り専用で)実行します:bash scripts/verify.sh 02-DOCS/shortform/。

重要なメトリクス

生の視聴回数ではなく、これらでスコアと判断を行います。理由:視聴回数は遅延指標でゲーム可能です;これらはアルゴリズムが実際に報酬を与えるレバーです。

メトリクス読み方ソースの事実
3秒保持率>60% = 強い;<40% = パターンを廃止最初の3秒で最大約50%のドロップ;>60%保持率のReelsは<40%のものより5~10倍のリーチを達成可能
フック率~28%がMetaのショートフォーム平均;それを上回れ最初の3秒でのフック/ジャンプカットは、バイラル可能性が約72%高いことと相関
シェア+保存発見の通貨 — スコアリングで重み付けアルゴリズムは視聴時間とシェアを分布に報酬として与える
長さあたりの視聴時間10秒@80%は60秒@30%より優れている長さではなく、長さに対する保持率を最適化する

アンチパターン

アンチパターンなぜ失敗するか代わりにすべきこと
スコアのないブレインストームダンプ順位付け不可能;ユーザーは何を最初に撮影すべきか決定できないアイデアごとにスコアを持つ順位付けされたバックログテーブルを常に出力する
30日間のみのトレンドサウンドを追いかける30日間のみの動きは、サウンドがすでに死にかけていることを意味することが多い7日間で上昇しているものを重み付け;30日間のみを stale とフラグ
ログが死んだと証明したトピックを再提案するアカウント自身の否定的な証拠を無視するスコアリング前にフェーズ1の失敗をチェック;証明された失敗を決して提案しない
トレンドのためにクリエイティブセンターをスクレイピングする利用規約に違反し、ループを壊し、脆いコードを出荷する手動/支援によるキャプチャ、または認可されたAPI;アーティファクトにスクレイピングコマンドをゼロに
トピックの興味ではなく、フックの強さでスコアリングする魅力的なトピックでも最初の3秒が死んでいれば失敗するフックの強さは×3の重み;最初のフレームを最初にスコアリングする
ベットを記録するが結果を記録しないループは決して学習せず;次のバッチは再推測する結果フィールドを残して記入する;フェーズ1は判定を読み取る
ここで完全なスクリプト/タイムコードを書くvideo-shorts に侵入;アイデア台帳を混乱させるフックライン+選択したサウンドで停止;引き継ぐ
日付のないトレンドシグナルをキャプチャする新しさはスコア不可能;死んだサウンドをブリーフィングする可能性があるすべてのシグナルは最初に見られた日付を運ぶか、フェーズ3に入らない

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ericrisco/rsc-harness

Use when writing the words on a single conversion page — the hero headline and subhead, the offer, the proof and testimonials, and one primary CTA — or diagnosing a page that gets traffic and does not convert, as a copy problem rather than a layout one. NOT the paid ad that drives the click (that is `ads`), NOT the visual layout the words sit in (that is `design`), NOT the experiment that picks the winning variant (that is `ab-testing`).

ericrisco/rsc-harness

Use when you need to render an actual video file with Remotion — React compositions, the Composition/Sequence/TransitionSeries graph, transitions, burned-in word-by-word captions from a transcript, automatic silence removal, b-roll overlays, headless CI renders, and a final MP4 or MOV. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT mastering audio to LUFS or building an RSS feed (that is `podcast`), NOT structuring the narrative arc (that is `course-storytelling`).

ericrisco/rsc-harness

Use when you have raw 9:16 footage and need it cut into a post-ready vertical short — dead air removed, fast jump cuts, karaoke word-by-word burned-in captions from a transcript, cuts and zooms snapped to the music beat, safe-area placement so captions clear the platform UI, and a platform-correct MP4 export. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT building a Remotion React composition codebase (that is `remotion-video`), NOT deciding when or where to post (that is `social-publisher`).

ericrisco/rsc-harness

Use when a vertical short is shot or scripted and you need the upload-form copy and cover that win the feed — the hook line, the first-frame on-screen text, the search-led caption, a tight hashtag set, and the cover frame; it learns from what performed via the 02-DOCS log. NOT inventing the idea (that is `shortform-ideation`), NOT scripting or directing the cuts (that is `video-shorts`), NOT executing the edit (that is `shortform-editing`), NOT scheduling the post (that is `social-publisher`).

ericrisco/rsc-harness

Use when the unit of work is a TikTok/Reels account, not one clip: positioning, sustainable cadence and format mix, ride-or-skip on a trend or sound, recurring series, diagnosing a flat account, and the dated learning loop. NOT the single script or hook variants (that is `video-shorts`), NOT the idea backlog (that is `shortform-ideation`).

ericrisco/rsc-harness

Use when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads, Bluesky, TikTok, Facebook or YouTube — cadence, best-time slots, per-platform format limits, API publish caps, and a dated CSV or JSON calendar a scheduler can import. NOT the brand voice the posts speak in (that is `brand-voice`), NOT the editorial strategy of what to make (that is `content-engine`).

ericrisco/rsc-harness

Use when connecting a real TikTok account to code via the Content Posting, Display and Business Account APIs — OAuth, chunked video publish with status polling, and pulling views, watch time and impression sources, then logging that performance into the wiki as a dated feedback record. Covers short-lived tokens breaking a cron, unverified pull-from-URL ownership, and rate limits. NOT what to post or how to package it (that is `shortform-strategy` and `shortform-packaging`).

ericrisco/rsc-harness

Use when scripting or directing the edit of a single vertical short that has to hold attention from the first frame — turning a topic, a clip or a long video into a shot-by-shot script and an edit decision sheet, fixing a hook that dies in second three, generating hook variants to test, and planning cuts and on-screen text. NOT scheduling or cross-platform cadence (that is `social-publisher`), NOT running the editorial calendar (that is `content-engine`), NOT defining the durable brand tone (that is `brand-voice`).

ericrisco/rsc-harness

Use to judge whether a short-form clip is worth publishing — scores a reel, short or podcast excerpt 0-100 on ten weighted criteria with automatic penalties, then ranks a batch and says where the cut-off falls. Run it on transcript candidates before rendering. NOT writing the hook or caption (that is `shortform-packaging`), NOT inventing the idea (that is `shortform-ideation`), NOT executing the edit (that is `shortform-editing`).

関連スキル