Communityコーディング&開発github.com

getedgehq/top-down-comms

クライアント向け文書の構成を最上位の思考から始め、逆ピラミッド構造で説得力を高めるスキルです。

top-down-comms とは?

このスキルは、AIエージェント(Claude Code などを想定)がクライアント向けのトップダウンコミュニケーション文書(提案書、報告書など)を作成・編集するためのルールセットです。マッキンゼーやBCGのコンサルタントが用いる構成技法に基づき、主張が逆転した文書(防御的な開き、結論を後回しにする構成)を防ぎます。主なルールは7つ:1. 最初の文は「回答」であること、2. 見出しはアクションタイトル(結論)で構成、3. 状況→複雑化→解決(SCR)の流れを守る、4. 除外事項や注意点はメタデータとして扱い冒頭に置かない、5. セクションに番号を付ける、6. 最後に反証可能な次のステップを示す、7. 漏れなく重複なく(MECE)を徹底する。各ルールには具体例とチェックリストが付属しており、AIエージェントが文書をレビュー・生成する際に構造的な欠陥を自動検出・修正できるよう設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/getedgehq/skills/tree/main/top-down-comms

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

トップダウンのクライアントコミュニケーション

トーンスキルは「どのように聞こえるか」を教えますが、このスキルは「何が最初に来るか、そしてなぜか」を教えます。完璧なトーンで書かれても、主張が逆転していれば失敗します。

このスキルが阻止しようとする失敗

あるレビュアーが、すでに3回のビジュアルレビューを通過した提案書に対してこう言いました: 「だいぶ良くなったが、ストーリーラインを直せ。なぜこれを最初に持ってくる?これをマッキンゼー、BCG、トップダウンコミュニケーションのコンサルタントの視点から考えてみろ。」

そのページは 「ソース画像の自動分析は行いません」 というスコープ除外から始まっていました。正当な理由がありました:先方の専門家が機械のベンチマークを上回っており、責任問題が彼らの本音の懸念事項だったからです。しかし、読者の第一印象は「この文書が何でないか」に関する免責事項であり、セクション3まで読まなければ、実際に何を提案しているのかわかりませんでした。

防御的な冒頭は「責任感があるように見えて、弱々しく読める」 のです。警告を先に持ってきてしまう本能こそ、まさに打ち消すべき本能です。

ルール1:統治理念(governing thought)を最初に持ってくる

ミントのピラミッド構造です。最初の実質的な文は答えであり、背景、話題、注意点ではありません。その下のすべてがそれを支えます。

冒頭の例判定
「ソース画像の自動分析は行いません。」除外。何でないかを述べている。
「受注を限界利益順にランク付けする」トピックラベル。件名を挙げているだけで、何も主張していない。
「フルキャパシティのときの課題は注文をいくつ受けるかではなく、どれを受けるかです。提案:すべての受信リクエストを期待限界利益で自動スコアリングします。」答え。推奨事項+理由、ページの最初に来ている。

テスト:読者が1文目で止まったとき、あなたに何をしてほしいか分かりますか? 分からないなら、1文目を書き直してください。

ルール2:アクションタイトル(トピックラベルではない)

すべてのセクション見出しはその結論を述べます。見出しだけを読んだ読者が議論全体を把握できるようにします。これは最もレバレッジが効く一手であり、最も頻繁にスキップされるものです。

トピックラベル(弱い)アクションタイトル(正しい)
背景ボトルネックは需要ではなくキャパシティである
スコアリングのロジック5つの基準が注文の真の価値を決定する
例同じ朝に届いた2つのリクエスト、同じ工数、異なる利益
テスト構築前に1時間で確認可能
工数実行まで数日

見出しだけのテスト。 本文を削除し、見出しだけを順に読んでください。それらが一貫した議論を形成していなければ、構造が間違っており、どれだけの本文もそれを救えません。

ルール3:SCR — 複雑化部分が仕事の本丸

状況(両者が同意している事実)→ 複雑化(なぜそのままではいけないのか)→ 解決(あなたの推奨)。多くの弱い文書には状況と解決はあるが複雑化がなく、推奨が動機付けられずに唐突に現れます。

複雑化は可能な限り算術的に表現すべきです:「到着順に注文を処理する代わりに利益率順で処理しないと、薄利の注文を受けるたびに高利益の注文を逃すことになります。」 これは読者が検証できるメカニズムであり、受け入れなければならない主張ではありません。

ルール4:除外事項と注意点はメタデータとして扱う

それらは冒頭近くのスキャンストリップか、最後の番号付きセクションに配置します。冒頭の位置や、推奨事項の前の見出しにしてはいけません。

「一目でわかる」ストリップ がこの問題を解決します:統治理念の直下に配置する4セルの行です。

対象               対象外              データソース           次のステップ
注文を処理する     ソース画像の        会計エクスポート、    20~30件の請求書、
順序               自動分析            プロジェクトフォルダ  約1時間
                                         ではない

除外事項は最初の画面で見えるので、誰も「埋もれていた」とは言えません。しかし、謝罪ではなくスコープとして枠付けされています。反論が真剣に検討に値する場合は、最後に完全なセクションを与えてください。

ルール5:セクションに番号を付ける

01、02、03。コンサルタントがそうするのは、文書を会議で参照可能にするためです(「02に戻ってください」)。また、セクションが11もあることに気づかせてくれます。セクションが11あるということは、議論がなく、ただのリストがあるだけだということです。

ルール6:反証可能な次のステップを一つ

具体的で小さく、失敗できるもので終わります。「議論しましょう」ではありません。最も強いクローザーは、kill condition(失敗条件)を明示します:

もしランキングが間違っていれば、ロジックが間違っており、そのアイデアは死んでいる。

失敗できる提案は、失敗できない提案よりも信頼できます。特に、すでに何度も売り込みを受けてきた相手に対してはそうです。

ルール7:MECE、そして負荷のかかるセクションだけに絞る

セクションは重複してはならず、議論に穴を残してはなりません。2つのセクションが同じ点を述べているなら統合します。あるセクションが上の何も支えていないなら削除します。

同じ文書から実用的なテスト:注文優先順位に関する提案の途中に無関係な参考事例が置いてありました。レビュアーの指摘:「このテキストはランダムです…メールに入れるか、ここに置くなら明確な文脈が必要です。」 それは異なる統治理念を支えるものだったので、別のアーティファクトに属していました。カバーメールに移動し、ページは短くなり、強くなりました。

出荷前チェックリスト

  1. 最初の実質的な文は推奨事項であり、背景や注意点ではない。
  2. 見出しだけを読んで完全な議論になる。
  3. 述べられた複雑化があり、理想的には算術的である。
  4. 除外事項はスキャンストリップか最後のセクションにあり、冒頭ではない。
  5. セクションは番号が付けられ、MECEである。
  6. 締めくくりは具体的で反証可能な次のステップが1つである。
  7. ページ上の何も、異なる統治理念を支えていない。

ここでは扱わないこと

トーンとレジスター:このスキルは議論の順序についてであり、声のトーンについてではありません。短いクライアントメッセージの長さ制限、共有ページの構築と公開の仕組みは、別のトピックです。

Individual skills in this repo

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

getedgehq/agent-evals

Build evals for an AI agent that already does real work. Use when someone asks "how do I know my agent is right", wants to test an agent before trusting it, compare models on cost versus quality, or turn production failures into tests. Walks from first tasks and yes/no verifiers, to isolated environments, to a trace-driven improvement loop.

getedgehq/cli-ux-review

Audit a command-line tool for user-friendliness — clear situation / next-step / options in every output, colour-highlighted runnable commands, no raw jargon, no silent hangs. Invoke for "CLI UX audit", "review my CLI", "is this CLI intuitive", or before any CLI release.

getedgehq/generate-image

Generate images with OpenAI GPT Image 2 via the Codex CLI, billed through the user's ChatGPT Plus subscription (no OpenAI API key, no per-image API cost). Use when the user asks to create, generate, or make an image, picture, illustration, icon, hero graphic, or concept art from a text prompt.

getedgehq/harness-first

Diagnose and fix an unreliable, expensive, or unsafe LLM agent by auditing its harness (golden set, judge, cost caps, data layer, action approvals, tracing) before blaming or swapping the model. Use when someone says an agent is "burning tokens", "hallucinating", "brittle", gives inconsistent answers, asks whether to switch to a cheaper/better model, or wants to ship an agent or prompt change to customers.

getedgehq/http-error-triage

Run before concluding anything from an HTTP error on a third-party API. Separates a real credential/entitlement problem from a CDN or WAF block, a wrong endpoint, or a client-signature ban. Use whenever an API returns 401/403/402/429 and you are about to say "the key is dead", "credits are exhausted", "the plan lacks access", or "we are rate limited".

getedgehq/linkedin-media-prep

Convert, crop, resize, and compress images and videos for optimal LinkedIn upload quality and file size. Use when the user wants to prepare a photo, image, or video for LinkedIn (profile picture, cover photo, post image, article featured image, post video, or video ad), optimize file size for LinkedIn, crop and resize for LinkedIn dimensions, convert HEIC/RAW/PNG/MOV to LinkedIn-ready JPEG or MP4, or mentions LinkedIn media requirements, specs, or limits.

getedgehq/monid

>-

getedgehq/opendraft

An 18-agent pipeline that turns one topic line into a drafted

getedgehq/people-search

Find and rank professional people for recruiting, partnerships, sales, or research from user-provided data, public web sources, an authenticated search session, or a connected provider. Use for people discovery, LinkedIn or Sales Navigator search design, profile-list ranking, or provider filter translation.

getedgehq/rocketlist

Turn a CV into a shortlist of live startup roles from Rocketlist's public job board, including adjacent job titles the person would never have searched for, each with its published salary, the evidence for the fit, and a direct apply link. Use for "find roles I would be a strong fit for", career pivots, remote or VC-backed job hunts, and salary-visible role discovery.

getedgehq/security-audit-checklist

Run a comprehensive security audit across application code, cloud infrastructure, containers, CI/CD pipelines, and infrastructure-as-code. Covers privacy compliance, OWASP basics, secret leakage, API security, IAM misconfigurations, storage exposure, Kubernetes hardening, and network security. Use when the user asks to audit, review, or harden app or cloud security, check for secrets, scan for XSS/SQLi, verify security headers, review Terraform/CloudFormation, audit AWS/GCP/Azure configs, or perform any security-focused review.

getedgehq/shadcn-first

>-

getedgehq/skills

Develop or review a branded long-form YouTube channel using Simon Kaiser's public creator-led approach: audience fit, recurring formats, natural brand integration, Time with Brand, and an organic, paid, and Shorts strategy. Use for channel strategy, format briefs, and pilots.

getedgehq/skills

Build a YouTube strategy, evidence-backed idea slate, and title plus thumbnail package using Paddy Galloway's public method. Use when planning a channel, choosing concepts, or preparing a video before filming.

getedgehq/skills

Build or review a buyer-centered strategic narrative using Andy Raskin's public method. Use for sales or investor deck stories, homepage positioning, keynotes, launch narratives, and why-now messaging.

getedgehq/skills

Turn a product URL, launch brief, or approved script into a production-ready launch video. Use for product reveals, feature announcements, SaaS launches, and narrated product films; not for generic explainers or editing existing footage.

getedgehq/strip-image-ai-metadata

Strip C2PA and AI-generation metadata from images (PNG, JPEG, WebP) to remove "Generated by AI" / "ChatGPT" / "DALL-E" labels that platforms like LinkedIn, Instagram, and X display. Use when the user wants to clean AI-generated images before posting, remove AI attribution from photos, strip C2PA manifests, sanitize image metadata for professional use, or verify whether an image contains C2PA data.

getedgehq/workplan

Create, update, or close work plans for multi-step tasks. Use when starting refactors, bug lists, feature work, migrations, or any task with 2+ steps. Also use after auto-compaction to re-orient. Triggers: "workplan", "work plan", "create a plan", "what's the plan", "where was I", or when Claude detects

関連スキル