getedgehq/top-down-comms

Structure de communication descendante pour documents clients – ce qui vient en premier et pourquoi.

Qu'est-ce que top-down-comms ?

Cette compétence (skill) pour agents IA (Claude Code, Cursor, Codex) enseigne les principes de la communication descendante (top-down) dans un contexte de conseil. Elle explique pourquoi un document bien rédigé échoue si la structure de l'argument est inversée. Basée sur les méthodes de McKinsey et BCG, elle détaille sept règles : placer la pensée directrice en premier, utiliser des titres d'action, structurer en Situation-Complication-Résolution, traiter exclusions et réserves comme métadonnées, numéroter les sections, terminer par une étape falsifiable, et garantir l'exhaustivité MECE. La compétence est indépendante du ton ou de la voix – elle se concentre uniquement sur l'ordre logique des idées. Très utile pour les consultants, analystes et toute personne rédigeant des propositions ou des rapports destinés à des décideurs.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Communication descendante avec le client

Les compétences de ton vous disent comment cela sonne. Celle-ci vous dit ce qui vient en premier, et pourquoi. Un document parfaitement formulé mais dont l'argument est inversé échoue encore.

L'échec auquel cette compétence veut mettre fin

Un relecteur, sur une page de proposition qui avait déjà passé trois tours visuels : « C'est mieux maintenant, mais corrigez la trame narrative. Pourquoi devrions-nous commencer par cela ? Pensez-y du point de vue d'un consultant McKinsey, d'un consultant BCG et de la communication descendante. »

La page s'ouvrait sur « Aucune analyse automatisée de l'imagerie source » — une exclusion de périmètre. C'était là pour une bonne raison : les propres experts du destinataire avaient dépassé un benchmark machine, et la responsabilité était leur objection active. Mais la première impression du lecteur était une clause de non-responsabilité concernant quelque chose que le document n'était pas, et ils devaient atteindre la section trois avant d'apprendre ce qui était réellement proposé.

Les ouvertures défensives semblent responsables et se lisent comme faibles. L'instinct de mettre la réserve en avant est exactement l'instinct à outrepasser.

Règle 1 : la pensée directrice vient en premier

La pyramide de Minto. La première phrase substantielle est la réponse, pas le contexte, pas le sujet, pas la réserve. Tout ce qui suit la soutient.

OuvertureVerdict
« Aucune analyse automatisée de l'imagerie source. »Exclusion. Ce qu'il n'est pas.
« Classement des commandes entrantes par marge contributive »Étiquette de sujet. Nomme un sujet, n'affirme rien.
« À pleine capacité, la question n'est pas combien de commandes vous acceptez mais lesquelles. La proposition : noter automatiquement chaque demande entrante selon la marge contributive attendue. »La réponse. Recommandation + raison, en première page.

Test : si le lecteur s'arrête après la première phrase, sait-il ce que vous voulez qu'il fasse ? Sinon, réécrivez la première phrase.

Règle 2 : titres d'action, pas étiquettes de sujet

Chaque titre de section énonce sa conclusion. Un lecteur qui ne lit que les titres doit obtenir l'argument complet. C'est le levier le plus efficace et celui le plus souvent négligé.

Étiquette de sujet (faible)Titre d'action (correct)
ContexteLe goulot d'étranglement est la capacité, pas la demande
Logique de notationCinq critères décident de la valeur réelle d'une commande
ExempleDeux demandes le même matin, même effort, marge différente
Le testVérifiable en une heure, avant même de construire quoi que ce soit
EffortQuelques jours pour être opérationnel

Le test des seuls titres. Supprimez le corps. Lisez les titres dans l'ordre. S'ils ne forment pas un argument cohérent, la structure est erronée et aucun contenu ne la sauvera.

Règle 3 : SCR, et la complication est l'essentiel du travail

Situation (ce que les deux parties considèrent comme vrai) → Complication (pourquoi cela ne peut pas rester ainsi) → Résolution (votre recommandation). La plupart des documents faibles ont une situation et une résolution mais pas de complication, donc la recommandation arrive sans motivation.

La complication devrait être arithmétique dans la mesure du possible : « Si vous traitez les commandes dans l'ordre d'arrivée plutôt que par marge, chaque commande à faible marge que vous acceptez vous coûte une commande à marge élevée. » C'est un mécanisme que le lecteur peut vérifier, pas une affirmation qu'il doit accepter.

Règle 4 : exclusions et réserves sont des métadonnées

Elles appartiennent à une bande de survol près du haut ou à une section numérotée à la fin. Jamais en position d'ouverture, jamais comme titre avant la recommandation.

La bande « en un coup d'œil » résout ce problème : une ligne de quatre cellules directement sous la pensée directrice.

DANS LE PÉRIMÈTRE      HORS PÉRIMÈTRE         SOURCE DE DONNÉES        PROCHAINE ÉTAPE
L'ordre dans lequel    Analyse automatisée    Extraits comptables,     20 à 30 factures,
les demandes sont      de l'imagerie          pas les dossiers de      environ 1 heure
traitées               source                 projet

L'exclusion est visible au premier écran, donc personne ne peut prétendre qu'elle a été enterrée, mais elle est présentée comme un périmètre plutôt que comme une excuse. Donnez-lui une section complète à la fin si l'objection est suffisamment sérieuse pour le mériter.

Règle 5 : numéroter les sections

01, 02, 03. Les consultants le font parce que cela rend un document référençable lors d'une réunion (« revenez à 02 »). Cela vous oblige aussi à remarquer quand vous avez onze sections, ce qui signifie que vous n'avez pas d'argument, seulement une liste.

Règle 6 : une seule prochaine étape falsifiable

Terminez sur quelque chose de spécifique, petit et susceptible d'échouer. Pas « discutons-en ». La conclusion la plus forte nomme la condition d'échec :

Si le classement est erroné, la logique est erronée, et l'idée est morte.

Une offre qui peut échouer est plus crédible qu'une offre qui ne le peut pas, surtout face à une salle qui a déjà été séduite.

Règle 7 : MECE, et réduisez aux sections porteuses

Les sections ne doivent pas se chevaucher et ne doivent pas laisser un trou dans l'argument. Si deux sections font le même point, fusionnez-les. Si une section ne soutient rien au-dessus d'elle, supprimez-la.

Test appliqué à partir du même document : un cas de référence non lié se trouvait au milieu d'une proposition sur la priorisation des commandes. La note du relecteur : « le texte est aléatoire... soit il va dans l'email, soit s'il va ici, il doit y avoir un contexte clair. » Il soutenait une pensée directrice différente, donc il appartenait à un artefact différent. Il a été déplacé dans l'email de couverture et la page est devenue plus courte et plus forte.

Liste de vérification avant envoi

  1. La première phrase substantielle est la recommandation, pas le contexte ou une réserve.
  2. Les titres, lus seuls, forment un argument complet.
  3. Il y a une complication énoncée, idéalement arithmétique.
  4. Les exclusions se trouvent dans une bande de survol ou une section de clôture, jamais l'ouverture.
  5. Les sections sont numérotées et MECE.
  6. La conclusion est une prochaine étape spécifique et falsifiable.
  7. Rien sur la page ne soutient une pensée directrice différente.

Non couvert ici

Ton et registre : cette compétence porte sur l'ordre de l'argument, pas la voix. Limites de longueur pour les messages clients courts, ainsi que les mécanismes de construction et de publication d'une page de partage, sont des préoccupations distinctes.

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

Skills associés