Communitygithub.com

ニュースレターボイス

このスキルは、あなたの既存のボイスプロフィール(voice.mdとabout-me.md)の上に、ニュースレター専用の文体ルールを追加します。サンプル分析またはアーキタイプに基づいて、オープニング、構成、データの使い方、フォーマット、クロージングなどを定義したnewsletter-voice.mdを生成します。

ニュースレターボイス とは?

ニュースレターボイスは、AIコーディングエージェント(CodexやClaudeなど)が、ユーザーのニュースレター執筆を一貫したトーンと構造で行えるようにするためのスキルです。まず、プロジェクトのルートにvoice.mdとabout-me.mdが存在することを確認し、なければボイスビルダーの実行を促します。既存のファイルがあれば、ユーザーは過去のニュースレターのサンプル(最低2つ)を提供するか、あらかじめ用意された6つのアーキタイプ(データチュートリアル、逆説エッセイ、ケーススタディ、キュレーションダイジェスト、パーソナルエッセイ、インタビュー)から選択します。サンプルが提供された場合は、オープニングの公式、セクション構造、データ哲学、フォーマット、長さ、ボイスマーカー、欠落パターンを詳細に分析し、サンプルに基づいたカスタマイズされたルールを作成します。アーキタイプが選択された場合は、voice.mdとabout-me.mdで調整したデフォルトテンプレートを使用します。最終的なアウトプットは単一のnewsletter-voice.mdファイルで、対象読者、ボイス原則、オープニング公式、セクションフロー、データとエビデンス、フォーマットルール、クロージング、禁止事項、目標文字数が800〜1,200語で簡潔に記述されます。このスキルは、新たに架空のデータを作成せず、提供された情報のみに基づいて動作し、イギリス英語をデフォルトとします。

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

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

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

ドキュメント

ニュースレターボイス は何をしますか?

Codex および Claude ランタイム

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

前提条件の確認

このスキルがトリガーされたらすぐに、プロジェクトルートに voice.md と about-me.md があるか確認してください。

どちらかのファイルがない場合は、ユーザーに次のように伝えてください:

ニュースレターボイスは、あなたの一般的なボイスプロフィールの上に構築されます。最初に voice-builder を実行し(スキルをアップロードするか「my voice をビルドして」と言ってください)、その後、about-me.md と voice.md がプロジェクト内に揃ったら、ここに戻ってきてください。

そして停止します。両方のファイルが存在するまで続行しないでください。

両方のファイルが存在する場合は、それらを完全に読み、その後すぐにステップ1に進みます。

ステップ1. サンプルの確認

チャットでユーザーに尋ねます:

過去のニュースレターを2〜3号、私が学習できるものはありますか?

はい:ここに貼り付けてください(1メッセージにつき1号、または一度にすべて) いいえ:「archetype」と入力してください。あなたのボイスに合わせたテンプレートから構築します

応答を待ちます。

ユーザーが2つ以上のニュースレターを貼り付けた場合は、ステップ2aに進みます。 ユーザーが「archetype」と入力した場合は、ステップ2bに進みます。 ユーザーが1つのニュースレターを貼り付けた場合は、少なくともあと1つ尋ねます。1つしかない場合は、「1つのサンプルではパターン検出には不十分です。アーキタイプモードに切り替えて、その1つのニュースレターを参考点として使用しますか?」と提案します。

ステップ2a. サンプルベースの分析

すべてのニュースレターを完全に読んでください。1回限りの癖ではなく、号をまたいだパターンを探します。以下を抽出します:

オープニングの公式

  • 最初の3文が何をするか(具体的な結果、文化的観察、主張、場面、質問)
  • 最初の構造的区切りまでのオープニングセクションの長さ
  • 信頼性を高める手法(著者がどのように早い段階で権威を確立するか)
  • 価値の約束(読者が何を得られると伝えられるか)

セクション構成

  • 問題点または対比の設定
  • 名前付きフレームワークまたは自由散文
  • 番号付き手順、方法、または連続的な議論
  • 例と証拠のパターン
  • ボーナスまたは拡張セクション
  • クロージングの公式と署名

データ哲学

  • 号ごとの具体的な数字(数を数える)
  • ソースの帰属スタイル(リンク付き、名前付き、クレジットなし)
  • 例と抽象の比率
  • 限界や失敗の認識

フォーマット

  • 見出しの使用(頻度、階層)
  • リストの使用(番号付き、箇条書き、矢印)
  • 太字と斜体の使用
  • プロンプト、コードブロック、引用ブロックのフォーマット
  • 視覚的マーカー(矢印、チェックマーク、絵文字があれば)

長さ

  • サンプル間のワードカウント範囲
  • セクションごとのワードカウント

ニュースレター形式に固有のボイスマーカー

  • プロのヒントやコールアウト(頻度、フォーマット)
  • 将来を見据えたクロージング
  • サンプル間で一貫している場合の署名フレーズ
  • メタ透明性(著者がプロセスを振り返ったりフィードバックを求めたりするか)

欠落シグナル

  • すべてのサンプルに存在しない単語、構文、または構造
  • 著者が決して使用しないクロージングの動き
  • 著者が決して触れないトピック

その後、ステップ3に進みます。

ステップ2b. アーキタイプの選択

AskUserQuestion ツールを1つの質問で呼び出します:

[
  {
    "question": "どのニュースレターアーキタイプが、あなたが書きたいものに合いますか?",
    "header": "アーキタイプ",
    "multiSelect": false,
    "options": [
      {"label": "データチュートリアル", "description": "数字、フレームワーク、プロンプト付きのステップバイステップの方法"},
      {"label": "逆説エッセイ", "description": "立場を取り、それを守り、反対意見を名指しする"},
      {"label": "ケーススタディの分解", "description": "号ごとに1つのテーマを深く掘り下げる"},
      {"label": "キュレーションダイジェスト", "description": "毎週5〜7のリンクとあなたのコメント"},
      {"label": "パーソナルエッセイ", "description": "テーマについての内省、ストーリー優先"},
      {"label": "インタビューまたはプロフィール", "description": "号ごとに1人、Q&A形式またはナラティブ"}
    ]
  }
]

ユーザーがアーキタイプを選択した後、このスキルフォルダー内の references/archetypes.md から一致するデフォルトを読み込みます。newsletter-voice.md を書く前に、voice.md と about-me.md を使用してすべてのフィールドを調整します。出力ファイル内で、アーキタイプのデフォルトが使用されたことと、このファイルは5号公開された後に再確認する必要があることをフラグとして示します。

ステップ3. newsletter-voice.md の作成

プロジェクトルートに newsletter-voice.md を作成します。単一ファイル、800〜1,200語を目標とします。次の構造を使用します:

# ニュースレターボイス

## ソース
[サンプルベース: X ニュースレター号を分析] または [アーキタイプベース: [アーキタイプ名] を voice.md に合わせて調整。5号公開後に再確認。]

## 読者と目的
[このニュースレターを誰が読み、彼らが何を得るか。about-me.md と voice.md から記述。2〜3文。]

## ボイス原則
[ライティングが常に保持する3〜5の中核的原則。それぞれ短い宣言文。このユーザーの voice.md に調整。]

## オープニングの公式
[号の始め方。括弧で囲まれたプレースホルダー付きの具体的なテンプレートを2つ含める。例:「[具体的な結果と数字]。[信頼性マーカー]。[この号の価値の約束]。」オープニングセクションの目標ワードカウント。]

## セクションフロー
[号の標準構造、セクションごと、最大5〜8セクション。各セクションの役割と長さについての簡単なメモ。]

## データとエビデンス
[数字と例の使われ方。具体的なルール。例:「すべての主張には数字が必要」、「ソースはインラインでリンク」、「例と抽象の比率はおおよそ3:1」。]

## フォーマットルール
[見出し、リスト、太字、斜体、コードブロック、視覚的マーカー。何を使い、何を避けるか。サンプルまたはアーキタイプのデフォルトから導出。]

## クロージングと署名
[号の終わり方。将来を見据えた声明と要約のどちらか。サンプル間に一貫したものがあれば署名フレーズ(発明しない)。]

## このニュースレターが決してしないこと
[短いパラグラフ1つ、または3〜5項目。サンプル間の欠落パターンまたはアーキタイプのデフォルトから導出。禁止ワードリストではなく、行動のみ。]

## 長さ
[標準号のワードカウント目標。ユーザーが両方の形式を書く場合、より長い包括的ガイド用の別の目標。]

すべてのセクションをサンプル(または調整されたアーキタイプのデフォルト)から埋めてください。一般的な埋め草は禁止です。サンプルがカバーしていないものがあれば、「サンプル間で明確なパターンなし」と言い、推測しないでください。

ステップ4. 確認と引き渡し

ユーザーに伝えます:

ニュースレターのボイスが構築されました。newsletter-voice.md が about-me.md および voice.md と一緒にプロジェクトルートにあります。号の下書きをしたいときは、「ニュースレターを書いて」と言ってください。3つのファイルをすべて一緒に使用します。

[アーキタイプモードの場合:このファイルはアーキタイプのデフォルトから構築されたことを覚えておいてください。5号程度公開した後、実際のサンプルを使ってこのスキルを再実行し、よりシャープなプロフィールにしてください。]

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

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

  • newsletter-voice.md:読者、ボイス原則、オープニングの公式、セクションフロー、データ哲学、フォーマット、クロージング、欠落パターン、長さの目標をカバーするニュースレター固有のライティング指示

ルール

  • 実行前に、プロジェクトルートに voice.md と about-me.md が必要です。どちらかがない場合は停止し、voice-builder にリダイレクトします。
  • ユーザーがサンプルベースモードを選択した場合、最低2つのニュースレターサンプルが必要です。それより少ない場合はアーキタイプモードを提供します。
  • newsletter-voice.md は1,200語未満に保ちます。簡潔さは網羅性に勝ります。
  • ボイスシグナルを発明しないでください。サンプルまたは voice.md に調整されたアーキタイプのデフォルトのみから作業します。
  • voice.md の内容を複製しないでください。関連する場合はそれを参照します。newsletter-voice.md はニュースレター固有のルールのみを追加します。
  • ユーザーの特定の名前、URL、署名フレーズは、2つ以上のサンプルで一貫して現れない限り、組み込まないでください。
  • 別のボイスや禁止ワードファイルを生成しないでください。欠落パターンは newsletter-voice.md 内の単一セクションとして存在します。
  • サンプルが明らかにアメリカ英語でない限り、全体でイギリス英語を使用します。
  • 出力ファイルや下書きでは、決してemダッシュを使用しないでください。

Individual skills in this repo

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

関連スキル