Communityコーディング&開発github.com

geoffrey-svg/trial-reels-starter

一回限りのセットアップです。ステップを順番に実行し、既に完了しているものはスキップします。各ステップでは、簡単な説明の後にアクションまたは質問が続きます。技術的な詳細は説明しません。

trial-reels-starter とは?

このスキルは、Trial Reels Starter のセットアップを段階的に案内するためのものです。ユーザーは、最初に必要なツール(ffmpeg、Pillow、fontTools)をインストールし、次に自身のスタイル(フォント、色、レイアウトなど)を設定します。その後、Instagram にリールを投稿する方法として、Metricool、Zernio、または手動投稿の3つのオプションから選択します。Metricool または Zernio を選択した場合は、API キーを設定してアカウントを連携します。最後に、1日あたりの投稿数や投稿時間帯などのルールを設定し、リールが「勝者」とみなされる基準を定義します。このスキールは、Claude Code や Cursor などの AI エージェント上で動作し、ユーザーが Trial Reels の自動投稿システムを簡単に構築できるようにします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/geoffrey-svg/trial-reels-starter/tree/HEAD/setup

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

Trial Reels Starter のセットアップ

一回限りのセットアップです。ステップを順番に実行し、既に完了しているものはスキップします。各ステップでは、簡単な説明の後にアクションまたは質問が続きます。技術的な詳細は説明しません。

ステップ 1: ツール

  1. このディレクトリで ./install.sh を実行します。ffmpeg(動画作成)と 2 つの Python コンポーネント(Pillow と fontTools)をインストールし、既に存在するものはスキップします。
  2. Homebrew がインストールされていない場合は、brew.sh からインストールするようユーザーを支援します。その際、ユーザーは Mac のパスワードをターミナルに入力する必要があります。何が表示されるか(入力中はパスワードが表示されないこと)を説明し、その後 ./install.sh を再実行します。
  3. 「ツールの準備ができました」とだけ伝えます。

ステップ 2: スタイル

  1. ユーザーが AI Suite から設定ブロック(tekst を含む JSON)を含むプロンプトを貼り付けた場合: そのブロックを python3 engine/scripts/instellingen.py --schrijf - で書き込み、質問はしません。
  2. それ以外の場合: AI Suite(Trial Reels タイル、サンプル付き)でスタイルを選択し、プロンプトを貼り付けるよう伝えます。それが嫌な場合は、1 つのメッセージで次の項目を尋ねます: フォント(一般的な名前とファイル名のリストは python3 engine/scripts/instellingen.py --lettertypes)、テキストをブロックにするか枠付きの個別の文字にするか、色、画面上の位置(上部、中央、下部)。
  3. 結果を表示します: python3 engine/scripts/voorbeeld.py(または --video <path> で独自の動画を指定)。自分で画像を確認し、ユーザーにも見せます。問題ないか尋ねます。

ステップ 3: 投稿方法

mijn-trial-reels/accounts.json は存在するが koppeling.json が存在しない場合、これはこの選択肢が追加される前(バージョン 1.0、Zernio 経由)のインストールです。何も尋ねず、新しいキーも作成せずに、python3 engine/scripts/sleutel.py --bewaard zernio を実行し、ステップ 5 に進みます。

リールがリンクを介して指定されたタイミングで Instagram に投稿されること、そしてユーザーが選択できることを数文で説明します。3 つのオプションを提示し、どれを希望するか尋ねます。

  1. Metricool: 既に使用している場合。リールは他の投稿と同様に Metricool プランナーに追加され、統計も Metricool から取得されます。必要なもの: Advanced プラン以上(API が含まれます。2026 年 10 月 19 日時点の metricool.com/pricing によると、年間契約で月額 €43 から)、および Metricool のブランドとしての Instagram アカウント。
  2. Zernio: Metricool を持っていない場合、または分けて管理したい場合。2 つまでの Instagram アカウントで無料、クレジットカードは不要。スケジュール設定と統計は Zernio を介して行われます。
  3. 他のプログラムで自分で投稿: 例: Later、Buffer、Instagram アプリ。システムはリールを作成するだけで、ユーザー自身が Trial Reel として追加し、統計はそちらで確認します。リンクは不要です: python3 engine/scripts/sleutel.py --zelf を実行し、ステップ 5 に進みます。

ステップ 4: リンクの設定

Metricool

  1. ./install.sh --metricool: cloudflared をインストールします。Metricool は動画を受け入れるために公開アドレスを必要とするため、システムはスケジュール設定中のみリールディレクトリを一時的に公開します。
  2. Metricool のヘルプセンター(help.metricool.com、「Metricool ユーザー ID を見つける方法」、2026 年 10 月 19 日閲覧)の説明に従い、Metricool で API 情報を検索するようユーザーに指示します。
    1. トークン: Metricool の アカウント設定 > API にあります。Advanced および Custom プランでのみ利用可能です。
    2. ユーザー番号 (userId): ブラウザで Metricool を開き、ブランドを開きます。アドレスバーに ...?blogId=12345&userId=1234567 のように表示されます。userId= の後の番号がユーザー番号です(blogId= の後の番号はブランド番号で不要です)。
  3. トークンとユーザー番号をチャットに貼り付けてもらいます。printf '%s' '<token>' | python3 engine/scripts/sleutel.py --metricool --user <ユーザー番号> で保存します。トークンを回答内で繰り返さないでください。スクリプトは最初に Metricool で検証します。うまくいかない場合は、ユーザーに確認してもらいます(また、プランに API が含まれているかどうかも確認します)。
  4. python3 engine/scripts/koppel.py で Instagram アカウントを持つブランドが表示されます。python3 engine/scripts/koppel.py --gebruik <Instagram名> で正しいものを有効にします。その Instagram アカウントが 2 つのブランドに属している場合は、スクリプトがブランド番号を尋ねます。ユーザーにどのブランドか尋ね、--gebruik <番号> を使用します。

Zernio

  1. ユーザーに zernio.com でログインまたはアカウント作成を依頼します。そこで API keys を開き、Create API key をクリックします。キーはすぐにコピーするよう伝えます(Zernio は一度しか表示しません)。キーは sk_ で始まります。
  2. キーをチャットに貼り付けてもらいます。printf '%s' '<キー>' | python3 engine/scripts/sleutel.py で保存します。キーを回答内で繰り返さないでください。機能しない場合は、新しいキーを作成するようユーザーに依頼します。
  3. python3 engine/scripts/koppel.py --link で Instagram をリンクするためのリンクが表示されます。リンクを開く前に、Instagram でリンクしたいアカウントに切り替えるよう指示します。Instagram はログイン中のアカウントをリンクするためです。
  4. その後、python3 engine/scripts/koppel.py と python3 engine/scripts/koppel.py --gebruik <名前> を実行します。

両方に共通: Instagram では プロフェッショナルアカウント(クリエイターまたはビジネス)で 公開 設定が必要で、Trial Reels は フォロワー 200 人 からのみ利用可能です。それ以下の場合はシステムは通常のリールを投稿し、フォロワーにも表示されます。その旨を伝えます。複数のアカウントを追加する場合は、koppel.py --erbij <名前> を使用します(--gebruik はリストを置き換えます)。

ステップ 5: 投稿ルールと勝者判定基準

次の項目を 1 つのメッセージで尋ねます。デフォルト値も示し、「問題ない」と言えるようにします。

  1. アカウントあたり 1 日のリール数: デフォルト 5。新しいアカウントでは 1 日 2 ~ 5 から始めることを推奨。リンク経由の場合、Instagram はアカウントあたり 1 日約 5 件の Trial Reel しか許可しないことが多く(自身のアカウントで測定。それ以上は Instagram が拒否)、一度に何十件も投稿したテストアカウントはその後リーチを得られなくなりました。
  2. 投稿間の最小間隔(分): デフォルト 45(最小 30)。
  3. 投稿時間帯: デフォルト 9:00 ~ 21:00、ユーザーのコンピューターのタイムゾーン(間違っている場合は確認)。
  4. フォロワーへの公開: 好調な Trial Reel を Instagram アプリで手動で公開するか、Instagram に自動で公開させるか。
  5. リールが勝者となる条件: デフォルトでは、アカウントの通常のビューの少なくとも 3 倍、かつ最低 500 ビュー。リンク(Metricool または Zernio)がある場合のみ必要。

回答を python3 engine/scripts/instellingen.py --schrijf - で保存します。posten ブロックと winners ブロックのみを含めます(例: {"posten": {"per_dag": 3, "minuten_tussen": 45, "van": 9, "tot": 21, "tijdzone": "Europe/Amsterdam", "doorzetten": "zelf"}, "winners": {"factor": 3, "min_views": 500}})。スクリプトが何かを拒否した場合は、理由を説明して再入力を求めます。その後、現在の設定を 1 文で伝えます(python3 engine/scripts/instellingen.py)。ウィンドウに収まる数が選択した数より少ない場合は、そのように表示されます。

完了

2 ~ 3 文で、何ができるようになったかを説明します: 動画とテキストの提供、リールの確認、提案の承認(または自分で投稿する場合はリールの取得)、数日後の統計の確認。すぐに最初の小規模なラウンド(例: 5 リール)を作成することを提案します。

関連スキル