CommunityCodierung & Entwicklunggithub.com

getedgehq/top-down-comms

Dieses Skill vermittelt die Strukturregeln für Top-Down-Kommunikation in Kundenprojekten – von der Leitidee bis zum prüfbaren nächsten Schritt.

Was ist top-down-comms?

Dieses Skill befähigt KI-Assistenten (z. B. für Claude Code, Codex oder Cursor), Dokumente, Proposals oder E-Mails nach dem Top-Down-Prinzip zu strukturieren. Es leitet sich aus der Praxis von Beratungsunternehmen wie McKinsey & BCG ab und stellt sicher, dass der Leser die Kernbotschaft sofort erfasst – ohne sich durch Caveats oder Hintergrundinformationen kämpfen zu müssen. Das Skill definiert sieben klare Regeln: (1) Der erste Satz enthält die Antwort, nicht die Einschränkung; (2) Überschriften sind Handlungsaufforderungen, keine Themenlabels; (3) Situation-Complication-Resolution (SCR) wird erzwungen; (4) Ausschlüsse und Einschränkungen gehören als Metadaten in einen Scan-Streifen, nicht in die Eröffnung; (5) Abschnitte sind durchnummeriert; (6) Der Schlusssatz ist ein konkret, falsifizierbarer nächster Schritt; (7) Die Gliederung ist MECE und enthält nur tragende Abschnitte. Das Skill enthält außerdem eine Checkliste und Tests (z. B. den Headline-Only-Test), um die eigene Struktur zu prüfen. Es ist plattformunabhängig und kann in allen gängigen KI-Chat- oder Coding-Assistenten angewendet werden.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Top-Down-Kundenkommunikation

Tone-Skills sagen Ihnen, wie etwas klingt. Dieses Skill sagt Ihnen, was zuerst kommt – und warum. Ein perfekt formuliertes Dokument mit einer verkehrten Argumentation scheitert trotzdem.

Der Fehler, den dieses Skill verhindern soll

Ein Prüfer, auf einer Proposal-Seite, die bereits drei visuelle Runden durchlaufen hatte: „Das ist jetzt besser, aber korrigieren Sie die Erzählstruktur. Warum sollen wir damit beginnen? Betrachten Sie das aus der Perspektive eines McKinsey-Beraters, eines BCG- Beraters und der Top-Down-Kommunikation.“

Die Seite begann mit „Keine automatisierte Analyse der Quellbilder“ – eine Leistungsausgrenzung. Sie war aus gutem Grund da: Die eigenen Experten des Empfängers hatten einen maschinellen Benchmark geschlagen, und die Haftung war ihr aktueller Einwand. Aber der erste Eindruck des Lesers war ein Disclaimer über etwas, das das Dokument nicht war, und sie mussten bis zum dritten Abschnitt lesen, bevor sie erfuhren, was eigentlich vorgeschlagen wurde.

Defensive Eröffnungen wirken verantwortungsvoll und lesen sich schwach. Der Instinkt, den Vorbehalt voranzustellen, ist genau der Instinkt, den es zu überschreiben gilt.

Regel 1: Der Leitgedanke steht an erster Stelle

Mintos Pyramide. Der erste inhaltliche Satz ist die Antwort, nicht der Hintergrund, nicht das Thema, nicht der Vorbehalt. Alles darunter stützt sie.

EröffnungBewertung
„Keine automatisierte Analyse der Quellbilder.“Ausgrenzung. Was es nicht ist.
„Ranking eingehender Aufträge nach Deckungsbeitrag“Themenlabel. Nennt ein Thema, behauptet nichts.
„Bei Vollauslastung geht es nicht darum, wie viele Aufträge Sie annehmen, sondern welche. Der Vorschlag: Jede eingehende Anfrage automatisch nach dem erwarteten Deckungsbeitrag bewerten.“Die Antwort. Empfehlung + Grund, als erstes auf der Seite.

Test: Wenn der Leser nach Satz eins aufhört, weiß er dann, was Sie von ihm wollen? Wenn nicht, schreiben Sie Satz eins neu.

Regel 2: Handlungsüberschriften, keine Themenlabels

Jede Abschnittsüberschrift gibt ihre Schlussfolgerung an. Ein Leser, der nur die Überschriften liest, muss das gesamte Argument erhalten. Das ist der einzelne Hebel mit der größten Wirkung und der, der am häufigsten übersprungen wird.

Themenlabel (schwach)Handlungsüberschrift (richtig)
HintergrundDer Engpass ist Kapazität, nicht Nachfrage
BewertungslogikFünf Kriterien entscheiden, was ein Auftrag tatsächlich wert ist
BeispielZwei Anfragen am gleichen Morgen, gleicher Aufwand, unterschiedliche Marge
Der TestIn einer Stunde überprüfbar, bevor etwas gebaut wird
AufwandEin paar Tage bis zum Laufen

Der Nur-Überschriften-Test. Entfernen Sie den Fließtext. Lesen Sie die Titel der Reihe nach. Wenn sie kein zusammenhängendes Argument ergeben, ist die Struktur falsch, und keine noch so gute Textmenge wird sie retten.

Regel 3: SCR, und die Komplikation ist die ganze Arbeit

Situation (was beide Seiten als wahr anerkennen) → Komplikation (warum es nicht so bleiben kann) → Lösung (Ihre Empfehlung). Die meisten schwachen Dokumente haben eine Situation und eine Lösung, aber keine Komplikation, sodass die Empfehlung unmotiviert ankommt.

Die Komplikation sollte wo möglich arithmetisch sein: „Wenn Sie Aufträge in der Reihenfolge des Eingangs bearbeiten und nicht nach Marge, kostet Sie jeder dünn-margige Auftrag, den Sie annehmen, einen fett-margigen.“ Das ist ein Mechanismus, den der Leser überprüfen kann, keine Behauptung, der er glauben muss.

Regel 4: Ausschlüsse und Vorbehalte sind Metadaten

Sie gehören in einen Scan-Streifen am Anfang oder einen nummerierten Abschnitt am Ende. Niemals an die Eröffnungsposition, niemals als Überschrift vor der Empfehlung.

Der „Auf einen Blick“-Streifen löst das: eine Vier-Zellen-Zeile direkt unter dem Leitgedanken.

IM UMFANG            NICHT IM UMFANG       DATENQUELLE            NÄCHSTER SCHRITT
Die Reihenfolge,     Automatisierte        Buchhaltungsexporte,   20 bis 30 Rechnungen,
in der Anfragen      Analyse der           keine Projektordner   etwa 1 Stunde
bearbeitet werden    Quellbilder

Der Ausschluss ist im ersten Bildschirm sichtbar, sodass niemand behaupten kann, er sei versteckt, aber er wird als Umfang und nicht als Entschuldigung präsentiert. Geben Sie ihm einen ganzen Abschnitt am Ende, wenn der Einwand schwerwiegend genug ist, um einen zu verdienen.

Regel 5: Nummerieren Sie die Abschnitte

01, 02, 03. Berater tun das, weil es ein Dokument in Besprechungen referenzierbar macht („gehen Sie zurück zu 02“). Es zwingt Sie auch dazu, zu bemerken, wenn Sie elf Abschnitte haben, was bedeutet, dass Sie kein Argument, sondern nur eine Liste haben.

Regel 6: Ein falsifizierbarer nächster Schritt

Enden Sie mit etwas Konkretem, Kleinem und Fehlbarem. Nicht „lassen Sie uns diskutieren“. Der stärkste Abschluss benennt die Abbruchbedingung:

Wenn das Ranking falsch ist, ist die Logik falsch, und die Idee ist tot.

Ein Angebot, das scheitern kann, ist glaubwürdiger als ein Angebot, das nicht scheitern kann, insbesondere gegenüber einem Raum, der bereits überzeugt wurde.

Regel 7: MECE, und streichen Sie auf die tragenden Abschnitte zusammen

Abschnitte dürfen sich nicht überschneiden und dürfen kein Loch im Argument hinterlassen. Wenn zwei Abschnitte denselben Punkt machen, fassen Sie sie zusammen. Wenn ein Abschnitt nichts darüber unterstützt, löschen Sie ihn.

Angewandter Test aus demselben Dokument: Ein nicht verwandter Referenzfall lag mitten in einem Proposal zur Auftragspriorisierung. Die Anmerkung des Prüfers: „der Text ist willkürlich … entweder er kommt in die E-Mail, oder wenn er hierher kommt, muss es einen klaren Kontext geben.“ Er unterstützte einen anderen Leitgedanken, also gehörte er in ein anderes Artefakt. Er wanderte in die begleitende E-Mail, und die Seite wurde kürzer und stärker.

Checkliste vor dem Versand

  1. Der erste inhaltliche Satz ist die Empfehlung, nicht Hintergrund oder Vorbehalt.
  2. Überschriften ergeben für sich allein gelesen ein vollständiges Argument.
  3. Es gibt eine benannte Komplikation, idealerweise arithmetisch.
  4. Ausschlüsse stehen in einem Scan-Streifen oder einem Schlussabschnitt, niemals in der Eröffnung.
  5. Abschnitte sind nummeriert und MECE.
  6. Der Abschluss ist ein konkreter, falsifizierbarer nächster Schritt.
  7. Nichts auf der Seite unterstützt einen anderen Leitgedanken.

Nicht behandelt

Ton und Register: Dieses Skill befasst sich mit der Argumentationsreihenfolge, nicht mit der Stimme. Längenbegrenzungen für kurze Kundenmitteilungen und die Build- und Veröffentlichungsmechanik einer Freigabeseite sind separate Themen.

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

Verwandte Skills