Communitygithub.com

minkhant1996/soemind-forge

フック、台本、キャプションを生成するコピーライティングスキル。「何を投稿すればいい?」「台本を書いて」「フックを教えて」といったリクエストに応えます。

soemind-forge とは?

このスキルは、クリエイティブなコピーライティングのボトルネックを解消するために設計されたAIエージェントツールです。フック、動画/広告の台本、SNS投稿のキャプションを、実証済みのダイレクトレスポンスフレームワークを用いて生成します。主なプラットフォームとしてClaude Code(CLIモード)をサポートしており、`node workflows/cli.cjs` コマンドを通じて操作します。生成プロセスは三段階で構成されます:まず多様な角度からフックを提案し、ユーザーが選択 → 選択したフックに基づき、PASやAIDAなどのフレームワークで台本を生成 → 最後にプラットフォームごとに最適化されたキャプションとハッシュタグを出力します。このスキルは、既存のブランドガイドライン(brand.md)や過去のコピー例(style-copy)を自動的に参照し、一貫性のあるトーンを維持します。統計やお客様の声はプロジェクトファイルからのみ引用し、決して捏造しません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minkhant1996/soemind-forge/tree/HEAD/skills/write-copy

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

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

ドキュメント

コピーを書く(フック・台本・キャプション)

クリエイティブのボトルネックはメディアを生成することではなく、何を言うかを知ることです。このスキルは 実証済みのダイレクトレスポンスフレームワークを使ってフック、台本、キャプションを生成し、ユーザーが 選んで洗練できるようにします。ワークフローコマンドで動作します — スクリプトを書かずにCLIを呼び出してください:

node workflows/cli.cjs generateHooks '<json-args>'     # 同様に: generateScript, generateCaption

以下に示すTypeScript呼び出しシグネチャは各コマンドの引数を文書化しています — それを node workflows/cli.cjs <command> '<json-args>' に変換し、新しいファイルに貼り付けないでください。

プロジェクトのコンテキスト(project.md のオーディエンス/ペインポイント/オファー; brand.md のトーン/制約)が存在する場合は最初に取得し、コピーがブランドに沿い、restrictions に違反しないようにします。


ステップ 0: コピーを書く前に参考コピーを確認する

声の一貫性は例から生まれ、形容詞からは生まれません。フック、台本、またはキャプションを生成する前に:

  1. レジストリを確認して保存済みのコピー例を探します:
    node workflows/cli.cjs resolveAsset '["{name}","style-copy"]'   # コピー例を保持する style_references のID
    cat projects/{name}/assets/style/copy-examples.md 2>/dev/null
    cat projects/{name}/style-samples/caption-examples/*.md 2>/dev/null   # ユーザーのドロップインボックス
    
    見つかった場合→パターン(文章の長さ、絵文字の使用、ハッシュタグスタイル、CTAの言い回し、 形式)を抽出し、以下に書くすべてのものにミラーリングします。
  2. 何も保存されていない→一度だけ尋ねます:

    "過去にうまくいった投稿、キャプション、台本、またはコピースタイルが好きなアカウントはありますか?1〜3例(または「なし」— brand.mdから進めます)を貼ってください。"

    • 例が提供された→ projects/{name}/assets/style/copy-examples.md に保存し、 登録します(registerAsset '["{name}","style_references",...]')。将来の作品で再利用されます。
    • 「なし」→ brand.md のトーンから進み、どのトーンの仮定を立てたかを明記します。
  3. 例が存在する場合、コピーがどの参照にマッチしたかを prompts.txt に記録します。

ステップ 1: フック(全体を書く前に角度を選ぶ)

さまざまな角度にわたるフックのバリエーションを生成し、ユーザーに1〜2を選んでもらい構築します。

node workflows/cli.cjs generateHooks '{"topic":"AI学習計画アプリ","audience":"期末試験を準備する大学生","painPoint":"どこから復習を始めればよいかわからない","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }]  — 角度: problem | curiosity | result | contrarian | question | stat | story

角度ごとにグループ化して表示し、どれを使うか尋ねてください。 自動選択しないでください — フックが作品全体を決定します。


ステップ 2: 台本(フレームワーク駆動、尺に合わせて調整)

フックが選ばれたら、目的に合ったフレームワークで台本を書きます:

フレームワーク最適な用途
hook-retain-reward短尺動画(TikTok/Reels/Shorts)— デフォルト
PAS(Problem-Agitate-Solution)ペイン主導の広告
AIDA(Attention-Interest-Desire-Action)クラシックなダイレクトレスポンス
BAB(Before-After-Bridge)変革 / 結果
star-story-solutionお客様の声 / 創業者ストーリー
# フック: generateHooks から選ばれたフックテキストを渡す
node workflows/cli.cjs generateScript '{"brief":"60秒で復習スケジュールを作成するAI学習計画アプリ","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<選ばれたフックテキスト>","cta":"無料で試す — リンクはbio"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }

台本をラベル付きセクション(ナレーション + ビジュアルキュー)と推定尺で表示します。 estimatedDurationSeconds が目標から大きく外れている場合はフラグを立て、ユーザーがトリミング/拡張できるようにします。 この voiceover テキストは generateVoiceover() に直接渡され、シーンごとの visual キューは generateStoryboard() / 動画スキルに渡されます。


ステップ 3: キャプション(公開準備完了、プラットフォーム別)

ラストマイル — 実際に動画/画像とともに公開される投稿コピーとハッシュタグです。

node workflows/cli.cjs generateCaption '{"topic":"AI学習計画アプリ","platform":"instagram","tone":"フレンドリーで自信に満ちた","cta":"プロフィールのリンク","count":3}'   # platform: tiktok | instagram | youtube | facebook
# c.data.captions: [{ text, hashtags:[] }]

作品がクロス投稿される場合は、プラットフォームごとにバリエーションを生成します(各プラットフォームで長さとハッシュタグの基準が異なります)。 選ばれたキャプションを出力の隣に保存します(例: projects/{name}/output-contents/.../caption.md)。


連携方法

generateHooks → 選択 → generateScript → { voiceover → generateVoiceover,
                                          visual cues → generateStoryboard → 動画 }
                                       → generateCaption → caption.md

常に提案して確認 — オプションを提示し、理由を添えて1つを推奨し、ユーザーが編集できるようにします。 統計/お客様の声を捏造しないでください(project.md からの実際のもののみを取得します)。

関連スキル