Communitygithub.com

JasperKallfelz/shortform-edit-kit

リファレンスビデオ(Instagram/TikTok)を自身の素材でRemotionを使って再現し、TikTokやInstagramに投稿するためのワークフロー。ユーザーが参考動画を見せてその再現を希望する場合、写真ライブラリからクリップを探して編集する場合、Remotion編集を表示・レンダリング・公開する場合に活用します。

shortform-edit-kit とは?

このスキルは、InstagramやTikTokのリファレンス動画を分析し、自身の素材でRemotionを使って再現、その後SNSに投稿するための包括的なワークフローを提供します。まず、OpenCVを用いてフレーム単位でリファレンスを分析し、新しい要素の登場フレームと矩形を計測します。次に、macOSの写真ライブラリ(sqlite)からビデオクリップを抽出し、HDRからSDRへの変換や回転補正を行います。Remotion上で各クリップをスロットとして配置し、テキストをDSLで指定、縦長動画を16:9にレターボックスして背景にぼかしを入れます。編集後はタイプチェックとLintを実行し、リファレンスと並べて確認します。投稿時は常に下書きとして作成し、明示的な承認を得てから公開します。Graph APIやアップロードエンドポイントを利用し、大きなファイルはブラウザアップロードではなく署名付きURLでPUT転送します。ハッシュタグや改行は生テキストで渡し、URLエンコードしないように注意します。公開後のテキスト変更が難しいため、投稿前に必ず確認を行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JasperKallfelz/shortform-edit-kit/tree/HEAD/skills/reference-to-social-post-flow

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

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

ドキュメント

リファレンス → Remotion-Edit → 投稿

作業の流れ(概要)

  1. リファレンスをフレーム単位で分析する。 新しい要素の登場フレームと矩形を30fpsのフレーム差分で計測する(OpenCV: 隣接フレームの差分、閾値、バウンディングボックス)。4fpsのコンタクトシートから推定しない。リファレンス内のブランドマーク、ハンドル、透かしは除去し、他人の名前は自分のものに置き換える。
  2. 素材を準備する。 写真アプリのデータベース(sqlite、テーブルZASSET; ZKIND=1 = ビデオ)からクリップリストを取得。オリジナルファイルは写真アプリから書き出す(osascript … export … with using originals)。ビデオから静止画を見つけるには、Visionのフィーチャープリントをメディアライブラリのサムネイルと照合するか、コンタクトシートを使う。iPhoneのクリップは回転して保存されていることが多く、HDRであるため、プロキシ作成時にSDRに変換し、回転を考慮する。
  3. Remotionで編集する。 各クリップはPropsパネルのスロット(ファイル、開始秒)として扱う。テキストはワードDSLで指定。縦長動画は16:9にレターボックスし、背景にぼかしたコピーを配置する。
  4. 確認する。 Lintと型チェックを実行し、フレームをリファレンスと並べて確認してから「完成」とする。
  5. 表示する。 レンダリングファイルを送る代わりにStudioで表示する。ただし、レンダリングが明示的に要求された場合は除く。
  6. 投稿する。 テキスト、ハッシュタグ、アカウントについて明示的な承認を得た場合のみ投稿する。

API経由での投稿(スケジューラー、Graph API)

  • 必ず最初に下書きとして作成し、承認を待ってから公開する。一部のツールでは「下書き」も「即時公開」も設定されていない場合、自動的に投稿をスケジュールすることがあるため、事前にパラメータを確認すること。
  • 大きなファイルはブラウザのアップロードフィールド経由で送信しない(多くの場合数MBに制限されている)。代わりにサービスのアップロードエンドポイントを利用する(事前に署名付きURLをリクエストし、ファイルをPUTでアップロードし、アップロードを完了する)。
  • Instagram ReelsをGraph API経由で投稿する: コンテナを作成(タイプREELS、公開ビデオURL)→ ステータスが完了するまでポーリング → 公開 → 投稿を読み戻してテキストを確認する。
  • 説明文は生テキストとして渡す(実際の#と実際の改行を含む)。URLエンコードされたテキストはデコードされず、そのまま投稿に表示される。公開後のテキストは多くのツールで変更できない。
  • 公開範囲、デュエット、ステッチの設定はサードパーティツールでは設定できないことが多いため、アプリ内で確認すること。
  • 各プラットフォームの説明文、ハッシュタグ、カバー、音楽、テストリールに関する情報は docs/recherche-2026-10.md を参照。

ルール

  • 「待って、何もしない」と言われた場合は、素材が届くまで本当に何もしない。
  • スクリプトとサンプル動画が揃うまでは編集を開始しない。
  • 常に最高品質のオリジナルを使用し、プレビューは使わない。
  • 技術的に可能であっても、投稿や公開コンテンツの変更は明示的な承認を得た場合のみ行う。

Individual skills in this repo

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

関連スキル