Communitygithub.com

ericrisco/rsc-harness

縦型ショート動画のアップロード用コピーとカバーを生成します。フックライン、先頭フレームのオンスクリーンテキスト、検索最適化されたキャプション、厳選されたハッシュタグ、そしてカバーフレームを含みます。パフォーマンスログ(02-DOCS)から学習し、継続的に改善します。

rsc-harness とは?

このスキルは、縦型ショート動画(TikTok、Instagram Reels、YouTube Shorts)のアップロードに必要な「パッケージング」コピーを専門に生成します。動画自体のアイデア発案やスクリプト作成、編集、投稿スケジュールは担当範囲外であり、それらのスキルが別途存在することを前提とします。主な成果物は、視聴者の最初の3秒での離脱を防ぐためのフックライン(4~7語)、音声をオフにした視聴者向けの先頭フレームオンスクリーンテキスト(2~3バリエーション)、検索エンジン最適化を意識したキャプション(キーワードファースト)、トピック固有のハッシュタグ(3~5個)、そしてグリッド表示やShorts Shelfで機能するカバーフレームとそのオーバーレイテキストです。すべての成果物は、アカウント独自の「02-DOCS」パフォーマンスログから学習した効果的なパターンを基に設計されます。1つのバリエーションではなく、テスト用に複数のバリエーションを生成し、その結果をログに記録することで、データドリブンな改善サイクルを実現します。

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

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

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

ドキュメント

ショートフォームパッケージング(Short-form packaging)

あなたは、撮影済みまたはスクリプト化された縦型ショート動画をラップする文章とフレームを書き、それがフィードで生き残るようにします。クリップはすでに存在します。あなたの仕事は、アップロードフォームのコピーとカバーです。それらによって、スクロールする人が立ち止まるか、最後まで見るか、友達に送るかが決まります。あなたはアイデアではなく、スクリプトではなく、編集ではなく、スケジュールでもありません。素晴らしいクリップも弱いパッケージでは死にます。テストされたパッケージは、良いクリップを何倍にも成長させます。

あなたは、アカウント自身の02-DOCSログから取得した、測定された保持率とシェア数に対して最適化します。勘や最新の「バイラルフック」スレッドではありません。

あなたが生み出すもの

毎回、5つのアーティファクトと1つのフィードバックエントリを生成します。

  1. フックライン (Hook line) — 話し言葉または書き言葉のオープナー、4~7語。3秒目を乗り切らなければなりません。
  2. 先頭フレームのオンスクリーンテキストセット (First-frame on-screen text set) — 音声をオフにしたスクローラーがオーディオを再生するかどうかを決める前に読む、画面に焼き付ける文章。テスト用に2~3バリエーション。各7語以内。
  3. キャプション (Caption) — 検索主導で、キーワードを先頭に配置した文。
  4. ハッシュタグセット (Hashtag set) — トピックシグナルとなるタグを3~5個。ディスカバリーダンプは禁止。
  5. カバーフレーム + オーバーレイ (Cover frame + overlay) — グリッド/Shortsシェルフのビルボードとなるフレームと、その3~6語のオーバーレイ。
  6. 02-DOCS フィードバックエントリ (02-DOCS feedback entry) — 何が出荷されたか、どの指標が動いたか、何が勝ったか。

前提条件(省略不可)。 動画は撮影済みまたはスクリプト化済みであり、アイデア/アングルが決定している必要があります。スクリプトがない場合は、video-shortsにルーティングします。アイデアが確定していない場合は、shortform-ideationにルーティングします。ここでそれらを発明してはいけません。未決定のショートをパッケージングすることは、フック、キーワード、オーディエンスをすべて同時に推測することを意味します。

ルールゼロ:シードテストと送信のためにパッケージする

以下のすべての選択は、正確に2つの結果に役立ちます。それらを念頭に置いてください。

  • シードテストがすべてです。 TikTokとShortsは各アップロードをまず小さなシードオーディエンスにプッシュします。イントロの保持率が弱く、スワイプアウェイが多いと、広がる前に配信が止まります。イントロ保持率(3秒経過)70%以上が基準であり、最初の約3秒が、クリップが最後まで視聴されるかどうかの大部分を決めます。したがって、フック + 先頭フレームテキスト + カバーが、投稿全体の中で最もレバレッジの効くコピーです。
  • 送信と保存が通貨であり、いいねよりも重視されます。 InstagramのReelsランキング要因は、視聴時間、リーチあたりのいいね数、リーチあたりの送信数(DMシェア) です。モッセリは、送信数と保存数がいいね数よりも意図を示すと繰り返し述べており、それらをいいね数よりも重視するように扱ってください。「この人に送らなきゃ」と思わせるためにパッケージし、虚栄のいいねのためにパッケージしないでください。

まずは基礎を固める

文章を書き始める前に、アカウントを読んでください。これをスキップすると、すでに成果を出したものと矛盾する、他人の声の一般的なコピーが生成されます。

  1. 02-DOCS/wiki/shortform/ を読んで、ブランドボイスと過去のパッケージを確認します。
  2. パフォーマンスフィードバックログを読んで、どのフック、カバー、ハッシュタグがすでにイントロ保持率と送信数を向上させているかを確認します。勝っているパターンの形状を引き継ぎます。
  3. 決定されたアイデア/アングルを、それが存在すればshortform-ideationの出力から取得します。
  4. スクリプトがない、またはアングルが確定していないですか? 「外部」にルーティングします(Handoffsを参照)。ここで発明してはいけません。

パッケージを 02-DOCS/wiki/shortform/ に保存し、未加工のテスト結果を 02-DOCS/raw/shortform/ に保存します。shortform/ ウィキツリーは、tiktok-api や shortform-strategy の兄弟と共有される OKF v0.1 バンドルです。各保存されたパッケージ .md は、空でない type: shortform-package(推奨される title/tags/timestamp を含む)を持つYAMLフロントマターで始まり、相互参照は標準的なマークダウンリンクを使用し、決して [[wikilinks]] を使用しません。02-DOCS/raw/shortform/ の未加工フィードバックログは raw/ であり、wiki/ ではありません。フロントマターは不要です。完全なフロントマターとパターンの詳細は、references/package-templates.md にあります。

2秒の決断

スクローラーは2つの状態のいずれかであなたのショートに出会います。両方のために設計してください。

  • フィード/FYPから: フレーム1はミュートで再生されます。約60%が音を消して視聴するため、先頭フレームのオンスクリーンテキストがフックを伝えます。オーディオを再生するかどうかの判断が下される前に読まれます。
  • プロフィールグリッドまたはShortsシェルフから: 彼らはカバーフレームを最初に見ます。クロップされて、音もありません。

したがって、3つのアーティファクトが同じ約束を同じ言葉で伝える必要があります。話されるフック、先頭フレームのオンスクリーンテキスト(その無音の双子)、そしてカバーのオーバーレイです。それらを共同設計し、決して乖離させてはいけません。

フックライン + オンスクリーンテキスト

配信を決定づける3秒間。ルールとその理由:

  • 4~7語。 それより長いと、ミュート状態のスクローラーは読み終える前にスワイプします。
  • 約束または緊張で始め、前置きで始めない。 落ちか、賭け金を先に持ってきます。文脈はキャプションまで待てます。
  • オンスクリーンテキストは、話されるフックの無音の双子です。 フックを焼き付けテキストとして言い換え、音を消している大多数に伝わるようにします。安全ゾーン(上部ステータスバーと下部UI:キャプション、ボタン、プロフィールタップターゲットを避ける)の内側に配置します。
  • 2~3バリエーションのセットを出力し、決して1つだけにしてはいけません。 あなたはシードオーディエンスで測定するための仮説を出荷するのであって、守るための推測を出荷するのではありません。
悪い例良い例理由
「やあ皆さん、今日はですね...」「ToDoアプリを消しました。その理由はこちら。」約束を先に提示。3秒目を乗り切る。
「最後まで見てね!」「最後のステップをやる人は誰もいません。」具体的な賭け金のある未解決ループであり、懇願ではない。
オンスクリーン:(なし — オーディオに依存)オンスクリーン:「Notionに取って代わった3つのアプリ」ミュートの60%にフックを伝える。
フックがX、オンスクリーンテキストがYと言っているフックとオンスクリーンテキストが同じ5語を言っている双子の約束、乖離なし。

完全なパターンライブラリ(未解決ループ・数字・逆張り・賭け金・POV・ビフォーアフター)と悪い例→良い例のリライトは、references/package-templates.md にあります。

キャプション

キャプションは現在、検索ランキングフィールドであり、捨てるような文章ではありません。モッセリはキャプションをReelsのランキング要因として挙げており、TikTokとInstagram検索はキャプションの言語をページのコピーのように読み取ります。ルール:

  • 最初の文を、視聴者が実際に検索するキーワードフレーズで始めます。 — ティーザーや質問ではなく。キーワードで始まる最初の行が、クリップをアプリ内検索や「関連」レールに表示させるものです。ティーザー行はどこにも表示されません。
  • 最初の約100~150文字だけが「もっと見る」の前に表示されます。 キーワード、価値、そしてコードやリンクはそこに配置してください。残りは見られないかもしれません。
  • 適切な長さは約150~300文字で、文脈とエンゲージメントを提供します。意図的に教育的/SEO投稿の場合のみ500文字以上にしてください。ハードリミット(TikTok 4,000、Reels 2,200)は無関係です。最初の行が仕事をします。
  • 保存/送信に値する落ちと、1つのソフトなCTAで終わります。 「これを必要としている友達に送ってあげてください」は、「いいねとフォローをお願いします」よりも優れています。

目標に応じてキャプションの形状を選びます。

目標が以下の場合...キャプションの形状
アプリ内検索で上位表示(エバーグリーン、ハウツー)キーワードフレーズ → 価値 → ソフトCTA。200~400文字を目指す。
タイムリー/エンターテイメントクリップでのエンゲージメントパンチライン + 送信促進。約150文字に抑える。
悪い例良い例
「待っててね👀 信じられないよ」「ToDoアプリに取って代わった3つのNotionテンプレート(無料リンクはこちら)」
「新しい動画だよ!!チェックしてね🔥🔥」「1回の午後で1週間分のショートをバッチ作成する方法 — 正確なワークフロー」

ハッシュタグ

ルールは変わりました。古い30タグのダンプは今や逆効果です。

  • 3~5個のハッシュタグ。決してそれ以上は使いません。 Instagramは現在、投稿/Reelsを5個にハードキャップしており(Mosseri、2026年に移行中)、ハッシュタグは「アルゴリズムのためにコンテンツを分類する」と述べており、リーチを増加させるものではありません。TikTokのベストプラクティスも3~5個です(CapCut、ByteDanceの公式エディター)。10個以上はスパムのシグナルとなり、アルゴリズムに混乱したシグナルを与えます。
  • トピックシグナルであり、ディスカバリーではありません。 動画が何であるかをラベル付けする特定のタグを選びましょう。#fyp #viral #foryou のような広範なリーチベイトは避けてください。
  • プラットフォームごとに調整します。 同じクリップでも、各プラットフォームの検索オーディエンスに合わせてください。TikTokでランクインするタグが、Reelsではノイズになる可能性があります。
悪い例: #fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ... (あと22個)
良い例: #notiontemplates #productivitytips #notionsetup

カバーフレーム

カバーはグリッド/検索/シェルフのビルボードです。リプレイとプロフィール訪問を促進し、フィード内で再生されるものではありません。選択して指定します。

  • 動きが多く、コントラストが高く、または感情が最高潮に達するフレームを選びます。 — 表情豊かな顔か、視覚的な落ち。平坦で、話の途中のフレームは避けます。
  • クロップを尊重します。 ReelsカバーはReelsタブではフル9:16(1080×1920)で表示されますが、プロフィールグリッドでは3:4(1080×1440)にクロップされます — Instagramは2025年にグリッドを3:4に変更した際、1080×1920フレームの上部と下部約240pxを削除しました(postfa.st「Instagram Reels Size」、Buffer 2026)。フィードではさらに異なるクロップ(4:5、1080×1350)が適用されます。すべてのクロップを生き残る唯一の領域は**1:1の中央正方形(1080×1080)**です。したがって、すべてのカバーテキストをこの中央正方形の内側に配置すれば、グリッド、フィード、タブのすべてで安全です。
  • 3~6語のオーバーレイを追加します。 — フックと同じ言葉で、高コントラストにします。

カバーチェックリスト:

  • フレームに動き/コントラスト/顔があるか、または落ちを示している(平坦な中間フレームではない)
  • オーバーレイは3~6語で、フックラインと一致している
  • オーバーレイテキストは1:1の中央正方形の内側に配置されている(3:4グリッドクロップ、4:5フィードクロップ、9:16タブのすべてを生き残る唯一の領域)
  • テキストが上部ステータスバーと下部UIを避けている

学習ループ(02-DOCS)

これがスキルを複利効果にする核です。書く前に勝者を読み、出荷後に結果を追記します。 配信を動かす指標にログの鍵を合わせます。いいねではありません:

- shipped: "2026-06-02 / faceless productivity TikTok"
  hook: "I deleted my to-do app. Here's why."
  on_screen_text: "3 apps that replaced Notion"
  cover_overlay: "I deleted my to-do app"
  hashtags: ["#notiontemplates", "#productivitytips", "#notionsetup"]
  intro_retention: 0.74   # 3秒経過 — 基準は0.70
  sends_per_reach: 0.018  # DMシェア、シェアエコノミーの通貨
  saves: 312              # いいねよりも重視(意図シグナル)
  won: "number-led on-screen text beat the question variant on intro retention"

記入済みスキーマとプラットフォームごとに調整された例は、references/package-templates.md にあります。次のパッケージを書くときは、まずログを開き、勝った形状をミラーリングします。

テストはセットで、出荷は3つのプラットフォームに

スペックは共通です — 9:16、1080×1920、MP4 H.264/AAC — したがって、1つのパッケージはTikTok、Reels、Shortsで再利用できます。ただし、キャプションのキーワードとハッシュタグは各プラットフォームの検索オーディエンスに合わせて調整し、1:1の安全な正方形をInstagramで最も重要視します。2~3のフック + オンスクリーンテキスト + カバーのバリエーションを出荷し、どれがイントロ保持率と送信数を向上させたかを読み、それをログに記録し、繰り返します。

ハンドオフ

要求がアップロードフォームのコピーとカバーから外れた瞬間に外部にルーティングします。判断基準:それが上記5つのアーティファクトのいずれかであればここに留まります。そうでなければ兄弟スキルに回します。

要求ルーティング先
ショートのアイデア/トピック/アングルを発明するshortform-ideation
アカウントレベルの計画:ニッチ、頻度、プラットフォーム、成長shortform-strategy
話すスクリプト/ビートシートを書き、カットを指示するvideo-shorts
編集を実行する — キャプションの焼き付け、Bロール、音声同期shortform-editing
完成したショートをスケジュール/クロス投稿するsocial-publisher
プラットフォームのGraph/APIを介してプログラムでアップロードするtiktok-api / instagram-api
長尺YouTube動画のタイトル/説明/タグyoutube-packaging
すべてのコンテンツで再利用される永続的なブランドトーンを定義するbrand-voice

video-shorts との明確な線引き:その兄弟スキルは、各ビートの内部オンスクリーンテキストをナラティブの一部として所有します。あなたはパッケージングレイヤー — 単一の先頭フレームフックオーバーレイ、キャプション、ハッシュタグ、そしてカバー — を所有し、スクリプトの存在を前提条件として扱います。

アンチパターン

アンチパターン代わりに行うこと
キャプションがティーザーで始まる(「待っててね👀」)最初の文を検索されるキーワードフレーズで始める。
1つのフックだけを出荷し、セットにしないテスト用に2~3のフック + オンスクリーンテキストのバリエーションを出力する。
15~30個のハッシュタグをダンプする3~5個の特定のトピックタグ。IGは5個でハードキャップ、TikTokのベストは3~5個。
いいねベイトのCTA(「いいねボタンをスマッシュ!」)保存/送信のための落ち。送信と保存はいいねを上回る。
カバーテキストが1:1の中央正方形の外にあるオーバーレイを中央正方形の内側に配置する — 3:4グリッド、4:5フィード、9:16タブのクロップを生き残る帯域。UIを避ける。
フックと一致しないオンスクリーンテキストオンスクリーンテキストを無音の双子にする — 同じ言葉。
02-DOCSログを無視して書くまず過去の勝者を読み、勝っている形状を引き継ぐ。
スクリプト/アイデアが存在する前にパッケージングする最初に video-shorts / shortform-ideation にルーティングする。
同じキャプションをすべてのプラットフォームにコピーペーストする各プラットフォームの検索オーディエンスに合わせてキーワードとハッシュタグを調整する。
成功指標としていいねをログに記録するイントロ保持率、リーチあたりの送信数、保存数をログに記録する。

検証

scripts/verify.sh <package-file> は、1つのパッケージドラフトに対する読み取り専用、ネットワーク不要のリントです。フックセットに2つ以上のバリエーションがある、オンスクリーンテキストが存在し各行7語以内である、キャプションの最初の文が約150文字以内で禁止されたティーザーで始まっていない、ハッシュタグの数が3~5個である、カバーフレームとオーバーレイが存在する、そして intro_retention、sends_per_reach、saves を含む 02-DOCS フィードバックブロックが存在することをチェックします。クリーンまたは空のファイルは終了コード0で終了します — 誤った失敗は決してありません。評価ケースの実行方法については evals/README.md を参照してください。

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 Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).

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`).

関連スキル