Communitygithub.com

バンガー解説 — 共有されても生き残る教材コンテンツ

説明コンテンツが「読みやすいが再現できない」か「正確だが誰も共有しない」という二つの極端に陥らないように、各レジスターをそれが得意とする部分に割り当てる手順です。

バンガー解説 — 共有されても生き残る教材コンテンツ とは?

Banger Explainerは、技術解説コンテンツを書くための体系的な手順です。よくある問題として、解説が「面白いが読者が再現できない」か「正確だが堅苦しくて共有されない」の二極化に陥ることがあります。このスキルは、説明の各要素(フック、メカニズム、証明、判断)を適切なレジスターに分割することで、両方のバランスを取ります。具体的には、読者の間違ったモデルを特定し、それを置き換えるメカニズムを一文で定義し、実証可能なアーティファクト(リポジトリ、コマンド、エラーなど)に基づいて説明します。フレーム(著者の声、ストーリー)とペイロード(技術的な明確さ)を厳密に分離し、プラットフォーム(X/Bluesky、LinkedIn、ニュースレターなど)に応じて形状を変えます。このスキルは、Claude Codeのプラグインシステムで動作し、参照フレームワーク(技術的明確性、文章品質、音声とオーディエンス)を動的に読み込んで、確立された品質ゲートを通過したコンテンツのみを生成します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jeff-Kazzee/bangers/tree/main/skills/banger-explainer

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

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

ドキュメント

バンガー解説 — 共有されても生き残る教材コンテンツ は何をしますか?

教材コンテンツは二つの方向で失敗します。個性が強すぎると読者は楽しめますが再現できません。仕様が多すぎると、誰も共有しないドキュメントのように読めます。この手順は、各レジスターをそれが実際に得意とする部分に割り当てます。

最初に読み込む

  • ${CLAUDE_PLUGIN_ROOT}/references/frameworks/voice-and-audience.md — オーディエンスプロファイルと作成者のハード制約。
  • ${CLAUDE_PLUGIN_ROOT}/references/frameworks/technical-clarity.md — フレーム/ペイロードの分割とペイロードの規律。ここが主要参照。
  • ${CLAUDE_PLUGIN_ROOT}/references/frameworks/writing-quality.md — ライブゲート。配信前に実行。
  • ${CLAUDE_PLUGIN_ROOT}/references/platforms/platform-playbook.md の対象プラットフォームセクション。

新鮮さゲート

このスキルまたはプレイブックからのプラットフォームベンチマーク、アルゴリズムの主張、数値パフォーマンスの主張を使用する前に、references/research/source-ledger.md で有効期限が切れていないサポートを確認してください。サポートがないか、レビュー期限を過ぎている場合は、banger-research を実行し、その主張を「未検証」とラベル付けするか、省略してください。

ステップ1: メカニズムに名前を付ける

自分のためだけに一文を書いてください。読者はこれを理解した後、以前は知らなかった何を理解するのか? 1つの作品につき1つのメカニズム。2文かかる場合は、2つの作品です。

次に、読者がおそらく今抱いている間違ったモデルに名前を付けます。強力な技術コンテンツは、空白を埋めるのではなく、間違ったモデルを置き換えます。その間違ったモデルが通常はフックになります。

ステップ2: 証明を確認する

草稿を書く前に、以下に名前を付けてください:

  • アーティファクト(リポジトリ、ファイル、コミット、スクリーンショット、エラーテキスト、ベンチマーク)、
  • 実際に何が起こったか(失敗した部分を含む)、
  • テストされていないことは何か、明確に述べてください。

アーティファクトがない場合、これは解説ではなく意見記事です。banger-threads または banger-longform-written にルーティングし、そのように伝えてください。

ステップ3: 説明の深さを設定する

voice-and-audience.md のオーディエンスプロファイルを使用します。第一の原則が支配します:語彙をオーディエンスの実際の洗練度に合わせます。

  • 非専門家オーディエンス — すべてのプリミティブを同じ息で、平易な類推を使って定義します。正確な画面、プロンプト、結果を示します。ペイロードは長くなり、ステップは小さくなります。決して見下すような言い方をしないでください。
  • 実践者オーディエンス — 業界内の省略表現は自由に使い、過剰な説明は彼らの時間を無駄にします。トレードオフ、失敗モード、そしてあなたが違う方法で行うであろうことにスペースを割いてください。

ステップ4: 分割して草稿を書く

フレーム(著者の声。明確さのルールではない):

  • カテゴリではなく、特定の間違ったモデルまたは特定の苦痛に名前を付けるフック。
  • ストーリー:何をしていたか、何が壊れたか、どれだけのコストがかかったか。
  • 判断:今何を考えているか、そしてその自信の度合い。
  • プラットフォーム固有の行動喚起。

ペイロード(技術的な明確さ):

  • 概念ごとに1つの名前、作品全体で統一。
  • 一文につき1つのアイデア、約25語、ステップでは20語に近づける。
  • 能動態、名前のある行為者:「パーサーがファイルを読み取る」。
  • 動詞を使い、名詞化は避ける。数字を示し、品質を主張しない。
  • 具体的なアーティファクト:実際のコマンド、実際のエラー、実際のパス。

縮約形、余談、ユーモア、意見は、それらが重みを持つペイロード内に留めてください。規律は平坦化と同じではありません。

ステップ5: プラットフォームの形状

  • X または Bluesky スレッド — 投稿ごとに1つのメカニズムステップ。フレームは最初の投稿と最後の投稿。ペイロード投稿には可能な限りコードブロックまたはスクリーンショットを含めます。メカニズムが必要とする以上に長くしないでください。
  • LinkedIn — 最初の150文字以内にフック、間違ったモデルのフレーミング、その後3~4つのペイロードビートを短い段落で。判断と質問で締めくくります。本文にリンクは入れないでください。
  • ニュースレターまたはSubstack — メカニズムステップごとにヘッダー、ステップごとに図またはコードブロック、判断をプルクォートします。ペイロードから抽出したスタンドアロンのNotesを提供します(フレームからは抽出しません)。
  • 動画説明またはドキュメントスタイルの投稿 — ペイロードが優勢、フレームは2行に縮小。
  • Facebookグループ — この手順は使用しないでください。banger-longform-written にルーティングし、質問主導で短くします。

ステップ6: 配信前に検証する

writing-quality.md ゲートを実行し、次に以下を実行します:

  1. 読者は投稿を閉じた状態でメカニズムを再現できるか?
  2. すべての概念が正確に1つの名前で呼ばれているか?
  3. 品質を示す代わりに品質を主張しているものはないか?
  4. フレームはまだ著者が声に出して言ったように聞こえるか?
  5. すべての数字、引用、結果が実際のアーティファクトにトレース可能か?
  6. 作成者のハード制約(禁止された句読点、フレーズ、トーン)が満たされているか?

出力形式

完成したアセットを先頭に、貼り付け可能な状態で、プラットフォーム用にフォーマットして出力します。次に:

  • メカニズム文とそれが置き換える間違ったモデル、
  • 各主張がトレースされるアーティファクト、
  • 「未検証」とラベル付けされたもの、
  • 次に必要な承認。

草稿は自由です。公開、スケジュール設定、アウトリーチには、作成者の明示的なアイテムごとの承認が必要です。

Individual skills in this repo

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

関連スキル