Communitygithub.com

ボイスビルダー

あなたの執筆スタイルとブランドボイスを分析・定義するためのスキルです。インタビューとサンプル分析を通じて、一貫性のあるパーソナルボイスプロファイルを生成します。

ボイスビルダー とは?

このスキルは、CodexやClaudeといったAIエージェント上で動作し、ユーザーのパーソナルブランドと執筆スタイルを体系的に構築・文書化します。ステップ1では、ユーザーに最大6つの質問からなる対話型インタビューを実施し、基本情報(名前、役割、対象読者、トピック、ホットテイク、ブランドプロミス、禁止事項)を収集します。その後、収集した情報を基に`about-me.md`ファイルを作成します。ステップ3では、ユーザーから3〜5個の執筆サンプルを収集し、サンプルがない場合はスキル内蔵のスターターサンプルを提供します。ステップ4と5では、サンプルを詳細に分析(文長、段落構成、フックスタイル、トーン、署名フレーズ、欠落パターンなど)し、その結果を`voice.md`ファイルに統合します。最後に、ユーザーに完了を伝え、次のアクション(ニュースレターボイスの作成、投稿作成、グラフィックデザイン、投稿スコアリング、プロフィール最適化など)を提案します。このスキルは、ブランドボイスを明確に定義し、コンテンツ作成の一貫性を保つために設計されています。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlie947/social-media-skills/tree/main/skills/voice-builder

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

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

ドキュメント

ボイスビルダー は何をしますか?

Codex および Claude ランタイム

  • Codex または Claude でこのスキルを使用する場合は、現在のタスクで実際に利用可能なツールを使用してください。AskUserQuestion の例は質問内容を説明しているものであり、必須のAPIではありません。利用可能な質問ツールをその制限内で使用するか、チャットで質問してください。すでに提供されている回答やソース資料を再利用してください。
  • ユーザーが選択したプロジェクトで作業してください。パーソナライズ作業の前に、そのプロジェクトの about-me.md、voice.md、および関連するブランドファイルを読んでください。ファイルに矛盾がある場合や、デフォルトの初期値が含まれている場合は、意図された著者を確認してください。不足している情報がある場合は質問するか voice-builder を実行し、メンテナーのID、アカウント、プライベートファイルを継承しないでください。
  • バンドルされている references/ は、このスキルフォルダを基準に解決してください。明示的にリクエストされたプロフィールのリフレッシュの場合は、既存の about-me.md、voice.md、または newsletter-voice.md をその場所で読み取り、更新し、無関係なユーザー情報やルールは保持してください。コンシューマーはそれらの正規ファイルを再読み取りする必要があります。新しいファイル名は、既存の無関係なファイルと競合する新しい成果物にのみ使用してください。インストールだけでインタビューを開始したり、ファイルを書き込んだりしないでください。リクエストがない限り、永続的な学習結果を書き込まないでください。
  • まず提供されたエビデンスを使用してください。必要に応じて、利用可能な検索/ソースツールを通じて外部の主張を検証してください。ソースや統合ツールが利用できない場合は、その不足している機能を明示し、提供されたテキストやエクスポート入力を提案してください。事実、一人称の経験、指標、ツールの実行成功を決して捏造しないでください。
  • 選択したルートに必要なサービスのみを、ユーザーの既存のアカウントを通じて接続してください。認証情報を出力したり、接続を上書きしたりしないでください。ドラフトの作成、保存、レビューは、公開、メッセージ送信、アカウント変更を許可しません。

重要: ロード時に自動開始

ユーザーがこのワークフローをリクエストした場合、ステップ1を開始してください。つまり、ユーザーへの次のメッセージはインタビューの質問となります。それ以外は何もしないでください。

以下のことは行わないでください:

  • このスキルを要約する
  • 作成するファイルを説明する
  • 仕組みを説明する
  • 「このスキルが含むものはこちらです」と言う
  • ユーザーに実行するかどうか尋ねる
  • インストールを確認する
  • 「今すぐ実行しますか?」のようなオプションを提供する

以下のことを行ってください:

  • ステップ1に直接進む
  • 最初のレスポンスとしてインタビューの質問を送信する

これは、ユーザーが自分のボイスを構築するよう依頼した場合、またはその目的でサンプルを提供した場合に適用されます。前置きなし、要約なし。最初にインタビューを行います。

ステップ1. アバウトミーインタビューの実行

上記のランタイムガイダンスに従って質問を行ってください。質問ツールが利用可能な場合は、そのスキーマとバッチ制限に従ってください。それ以外の場合は、同じ質問をチャットで行ってください。

AskUserQuestion は1回の呼び出しで最大4つの質問をサポートするため、2回の呼び出しを送信します。最初にバッチ1、回答を待ってからバッチ2を送信します。

バッチ1(最初のアクション、その前のテキストは不要)

これらの質問を、必要に応じてツールのスキーマに適合させて使用してください:

[
  {
    "question": "あなたの名前と職業は何ですか?",
    "header": "あなたについて",
    "multiSelect": false,
    "options": [
      {"label": "創業者", "description": "自身の会社やコンサルティングを運営している"},
      {"label": "マーケティング責任者", "description": "企業でマーケティングを統括している"},
      {"label": "クリエイター", "description": "コンテンツ制作を主な活動としている"},
      {"label": "営業リーダー", "description": "営業チームを率いている、または事業開発を担当している"}
    ]
  },
  {
    "question": "誰に向けて書いていますか?",
    "header": "読者",
    "multiSelect": false,
    "options": [
      {"label": "創業者とCEO", "description": "会社を経営する意思決定者"},
      {"label": "マーケター", "description": "あらゆるレベルのマーケティング専門家"},
      {"label": "求職者", "description": "次の役割を探している人々"},
      {"label": "その他の専門家", "description": "全く異なるグループ"}
    ]
  },
  {
    "question": "あなたが知られたいトピックは3〜5つ何ですか?",
    "header": "トピック",
    "multiSelect": true,
    "options": [
      {"label": "AIと自動化", "description": "AIツールが仕事を変える方法"},
      {"label": "マーケティング", "description": "戦略、コンテンツ、成長"},
      {"label": "リーダーシップ", "description": "マネジメント、採用、文化"},
      {"label": "パーソナルブランド", "description": "オーディエンスと評判の構築"}
    ]
  },
  {
    "question": "あなたの業界に対する見解、つまり他の人が信じていないあなたの信念は何ですか?",
    "header": "ホットテイク",
    "multiSelect": false,
    "options": [
      {"label": "ほとんどのアドバイスは間違っている", "description": "業界のコンセンサスは壊れている"},
      {"label": "人々は難しく考えすぎている", "description": "答えは人々が考えるより簡単だ"},
      {"label": "大きな変化が来ている", "description": "何かが変わろうとしており、ほとんどの人は準備ができていない"}
    ]
  }
]

バッチ2(バッチ1の回答が返ってきたらすぐに、間にコメントなしで送信)

以下の内容で再度 AskUserQuestion を呼び出します:

[
  {
    "question": "あなたの名前を見たときに人々に思ってもらいたいことは何ですか?",
    "header": "ブランドプロミス",
    "multiSelect": false,
    "options": [
      {"label": "この人は実用的だ", "description": "すぐに使えるものをくれる"},
      {"label": "この人は正直だ", "description": "他の人が言わないことを教えてくれる"},
      {"label": "この人は先を行っている", "description": "誰よりも先に来るものを見ている"}
    ]
  },
  {
    "question": "絶対に書かないことは何ですか?",
    "header": "禁止事項",
    "multiSelect": false,
    "options": [
      {"label": "政治", "description": "政治的な見解は決して述べない"},
      {"label": "私生活", "description": "プロフェッショナルな内容のみ"},
      {"label": "競合他社", "description": "他の人やブランドの名前を出したり、批判したりしない"}
    ]
  }
]

両方のバッチが回答されたら、ステップ2に進みます。回答が空白またはスキップされた場合は、その特定の質問をもう一度チャットで尋ね、その後先に進みます。

ステップ2. about-me.md を書く

プロジェクトルートに about-me.md を作成します。以下の構造を使用してください:

# アバウトミー

## 名前と役割
[質問1から]

## 読者
[質問2から、読者が誰であるかを2〜3文に拡張]

## トピックの柱
[質問3からの3〜5トピック、それぞれ1行]

## 見解
[質問4から、逆張りまたは特徴的な信念を明確な文章で記述]

## ブランドプロミス
[質問5から、著者が読者の頭の中に持たせたい唯一の考え]

## 禁止事項
[質問6から、決して書かないトピックや角度]

300語以内に収めてください。すべての行は、アシスタントが執筆時に参照するものにしてください。

ステップ3. サンプルの依頼

以下のように伝えてください:

ここに、あなたに学んでほしい執筆サンプルを3〜5個貼り付けてください。これらはLinkedInの投稿、ニュースレター、エッセイ、ブログ記事、メール、ツイート、またはあなたが公開した他の文章でも構いません。あなた自身のものでも、あなたが声を尊敬する誰かのものでも構いません。1回のメッセージで1つ、またはすべて一度に送ってください。サンプルがまだ準備できていない場合は、"サンプルを使用"と入力してください。後で差し替え可能なスターターセットを読み込みます。

ユーザーが貼り付けるのを待ちます。分析に移る前に最低3サンプル必要です。3つ未満の場合は、さらに依頼してください。

ユーザーが「サンプルを使用」と入力した場合、このスキルフォルダ内の references/sample-content.md から書き込みを読み込みます。サンプルの著者が誰であるかをユーザーに伝え、どのボイスを借用しているかを知らせてください。後で自分の文章に置き換えられることをリマインドしてください。

ステップ4. サンプルの分析

すべてのサンプルを読んでください。1つの作品の個々の癖ではなく、すべてのサンプルにわたるパターンを探します。以下を抽出してください:

ボイスシグナル

  • 平均文長
  • 段落リズム(単一行の改行、空白行、スタッカート vs 流れるような)
  • フックまたは冒頭スタイル(逆張り、質問、データポイント、ストーリー、告白、観察)
  • 視点(一人称、二人称、観察者的)
  • トーン(無表情、温かい、率直、遊び心、臨床的)
  • 署名フレーズや繰り返し使われる単語
  • CTAまたは締めくくりのスタイル

構造シグナル

  • 長さの範囲
  • リスト vs 散文
  • どのように始め、どのように終えるか
  • トランジションの扱い方

トピックシグナル

  • 複数のサンプルにわたって登場する主題
  • 読者が誰であるように見えるか
  • 著者が何を支持しているか

欠落シグナル

  • 一貫して欠落している単語や句読点(例:5サンプル中0サンプルでemダッシュ使用)
  • 著者が決して使わないフックタイプ
  • 著者が決して使わないトーン
  • 著者が避ける構造

ステップ5. voice.md を書く

プロジェクトルートに voice.md を作成します。これは、ボイスがどのように書くか、そしてボイスが何を避けるかの両方をカバーする単一の統合プロファイルです。別個のボイスファイルは作成しません。

# ボイスプロファイル

## どんな印象か
[全体的なボイスを平易な言葉で説明する2〜3文]

## トーン
[ボイスが一貫して発する3〜5の属性、その後にボイスが決して発しない1〜2のトーン。サンプルのギャップから導き出す]

## 文のリズム
[平均文長、ペース、段落構造。回避パターンを含める:例:スタッカートの断片は決して使わない、三拍子は決して使わない、25語を超える文はない]

## フックパターン
[観察された3〜5のフックタイプと、サンプルからのそれぞれの例。すべてのサンプルにわたって欠落しているフックタイプがあればそれも記載。例:修辞的質問は決して使わない、「こんな世界を想像してみてください」は決して使わない]

## 冒頭のスタイル
[1〜2文。サンプル全体で明確な回避パターンが存在する場合、ボイスが避ける冒頭の動きを記載]

## 締めくくりのスタイル
[1〜2文、CTAスタイルを含める。ボイスが避ける締めくくりの動きを記載。例:動機付けの要約は決してしない、「結論として」は決して使わない]

## 署名フレーズ
[サンプルから見つかった繰り返しの単語やフレーズ]

## 禁止事項
[すべてのサンプルに存在しない単語、句読点、または構文。サンプルが明らかに避けている項目のみをリストアップ。例:emダッシュなし(5サンプル中0)、ハッシュタグなし、コーポレートジャーゴンなし]

## このボイスが決してしないこと
[サンプルのギャップから導き出された3〜5の具体的な行動。具体的に。サンプルが「Xではなく、Y」という構文を決して使わないなら、それをリストアップする。特定の語彙セットを避けているなら、その単語を挙げる]

実際のサンプルからすべてのセクションを埋めてください。一般的な埋め草は禁止です。パターンが存在しない場合は、その旨を明記してください。about-me.md からの読者やトピックの柱を重複させないでください。

明示的なユーザーの禁止事項と、この小さなサンプルに単に存在しないパターンを区別してください。後者は暫定的なものとしてラベル付けし、サンプル数を示してください。欠落だけでは恒久的な禁止にはなりません。スターターサンプルは借用したスタイルを説明するものであり、ユーザーの経験や確立されたボイスを決して説明しません。

ステップ6. 確認と引き継ぎ

ユーザーに伝えてください:

ボイスプロファイルが構築されました。プロジェクトに2つのファイルが作成されました: about-me.md と voice.md です。これらのスキルは、このプロジェクトで呼び出されると両方のファイルを読み取ります。新しいタスクではスキルを発見し、同じプロジェクトコンテキストを使用する必要があります。いつでもファイルを開いて編集できます。

準備は完了です。次にできることは以下の通りです:

  • 「ニュースレターボイスを構築して」と言うと、ニュースレター用の執筆指示を作成します
  • 「投稿を書いて」と言うと、あなたのボイスでLinkedInの投稿を作成します
  • 「グラフィックをデザインして」と言うと、投稿用のビジュアルを作成します
  • 「投稿を採点して」と言うと、ドラフトに対するフィードバックを取得します
  • 「プロフィールを最適化して」と言うと、LinkedInプロフィールを再構築します

これらはそれぞれ別のスキルです。1つ選んで進めてください。

このスキルが生成するもの

プロジェクトルートに2つのファイル:

  1. about-me.md: ユーザーが誰か、読者、トピックの柱、見解
  2. voice.md: 統合されたボイスプロファイル。ポジティブシグナル(ボイスの書き方)と欠落シグナル(ボイスが避けること)の両方を1つのドキュメントでカバー

ルール

  • このスキルがトリガーされたら、ステップ1に直接進んでください。要約、説明、前置きは不要です。
  • サンプルコンテンツは常にコードブロック内に出力し、ユーザーが改行や空白を失うことなく正確なフォーマットをコピーペーストできるようにしてください。プレーンなコードブロック(言語タグなしのトリプルバックティック)を使用してください。
  • サンプルにあるものから作業してください。存在しないパターンをでっち上げないでください。
  • パターン検出には最低3サンプル必要です。3つ未満の場合はさらに依頼してください。
  • サンプルが互いに矛盾する場合は、voice.md でその矛盾を指摘し、平滑化しないでください。
  • about-me.md は300語以内に保ってください。
  • voice.md は500語以内に保ってください。
  • サンプルが明らかにアメリカ英語でない限り、全体を通してイギリス英語を使用してください。
  • 出力ファイルやドラフトでemダッシュを決して使用しないでください。
  • 別個の欠落プロファイルを作成しないでください。欠落シグナルは voice.md 内に含めます。

Individual skills in this repo

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

関連スキル