CommunityProgramación y desarrollogithub.com

getedgehq/top-down-comms

Define el orden y la estructura de la comunicación con el cliente, priorizando la idea principal antes que las advertencias o el contexto.

¿Qué es top-down-comms?

Esta habilidad enseña cómo estructurar la comunicación descendente (top-down) con clientes, un enfoque crítico para informes, propuestas y documentos de asesoría. A diferencia de las habilidades de tono, que se centran en cómo suena el texto, esta habilidad se enfoca en qué va primero y por qué. Está basada en principios probados de consultoría como la pirámide de Minto, MECE y SCR (Situación-Complicación-Resolución). La habilidad cubre siete reglas clave: comenzar con la idea rectora (no con exclusiones o antecedentes), usar títulos de acción en lugar de etiquetas de tema, incluir una complicación aritmética, tratar exclusiones como metadatos, numerar las secciones, terminar con un paso concreto y falsable, y mantener las secciones MECE. Está diseñada para plataformas como Claude Code, Cursor y Codex, y es útil para cualquier desarrollador o agente de IA que deba generar documentación persuasiva y bien estructurada para clientes o partes interesadas.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Comunicación descendente con el cliente

Las habilidades de tono te dicen cómo suena. Esta te dice qué va primero y por qué. Un documento con una voz perfecta pero un argumento invertido sigue siendo un fracaso.

El fallo que esto existe para detener

Un revisor, en una página de propuesta que ya había pasado tres rondas visuales: "Está mejor ahora, pero arregla la narrativa. ¿Por qué deberíamos empezar con esto? Piénsalo desde la perspectiva de un consultor de McKinsey, un consultor de BCG y la comunicación descendente."

La página abría con "Ningún análisis automatizado de las imágenes de origen" — una exclusión de alcance. Estaba ahí por una buena razón: los propios expertos del destinatario habían superado un benchmark automático, y la responsabilidad era su objeción en vivo. Pero la primera impresión del lector era un descargo sobre algo que el documento no era, y tenía que llegar a la sección tres antes de saber qué se proponía realmente.

Las aperturas defensivas se sienten responsables y se leen como débiles. El instinto de poner la advertencia al frente es exactamente el instinto que hay que anular.

Regla 1: la idea rectora va primero

La pirámide de Minto. La primera frase sustantiva es la respuesta, no los antecedentes, ni el tema, ni la advertencia. Todo lo demás la respalda.

AperturaVeredicto
"Ningún análisis automatizado de las imágenes de origen."Exclusión. Lo que no es.
"Clasificar los pedidos entrantes por margen de contribución"Etiqueta de tema. Nombra un asunto, no afirma nada.
"A plena capacidad, la cuestión no es cuántos pedidos aceptas, sino cuáles. La propuesta: puntuar automáticamente cada solicitud entrante según el margen de contribución esperado."La respuesta. Recomendación + razón, lo primero en la página.

Prueba: si el lector se detiene después de la primera frase, ¿sabe lo que quieres que haga? Si no, reescribe la primera frase.

Regla 2: títulos de acción, no etiquetas de tema

Cada encabezado de sección expresa su conclusión. Un lector que solo lea los encabezados debe obtener el argumento completo. Este es el movimiento de mayor apalancamiento y el que más a menudo se omite.

Etiqueta de tema (débil)Título de acción (correcto)
AntecedentesEl cuello de botella es la capacidad, no la demanda
Lógica de puntuaciónCinco criterios deciden lo que realmente vale un pedido
EjemploDos solicitudes la misma mañana, mismo esfuerzo, margen diferente
La pruebaComprobable en una hora, antes de construir nada
EsfuerzoUnos días para su ejecución

La prueba solo de encabezados. Elimina el cuerpo. Lee los títulos en secuencia. Si no forman un argumento coherente, la estructura está mal y ninguna cantidad de texto lo salvará.

Regla 3: SCR, y la complicación es todo el trabajo

Situación (lo que ambas partes acuerdan que es cierto) → Complicación (por qué no puede seguir así) → Resolución (tu recomendación). La mayoría de los documentos débiles tienen una situación y una resolución, pero ninguna complicación, por lo que la recomendación llega sin motivación.

La complicación debe ser aritmética cuando sea posible: "Si trabajas los pedidos en orden de llegada en lugar de por margen, cada pedido de bajo margen que aceptes te cuesta uno de alto margen." Eso es un mecanismo que el lector puede verificar, no una afirmación que debe aceptar.

Regla 4: las exclusiones y advertencias son metadatos

Pertenecen a una franja de escaneo cerca del principio o a una sección numerada al final. Nunca en la posición de apertura, nunca como encabezado antes de la recomendación.

La franja "de un vistazo" resuelve esto: una fila de cuatro celdas directamente debajo del pensamiento rector.

EN ALCANCE           FUERA DE ALCANCE      FUENTE DE DATOS        PRÓXIMO PASO
El orden en que      Análisis             Exportaciones          20 a 30 facturas,
se trabajan         automatizado de      contables, no          aproximadamente
las solicitudes     las imágenes          carpetas de           1 hora
                    de origen            proyecto

La exclusión es visible en la primera pantalla, por lo que nadie puede decir que estaba oculta, pero se presenta como alcance en lugar de disculpa. Dale una sección completa al final si la objeción es lo suficientemente grave como para merecerla.

Regla 5: numera las secciones

01, 02, 03. Los consultores lo hacen porque hace que un documento sea referenciable en una reunión ("vuelve a 02"). También te obliga a notar cuando tienes once secciones, lo que significa que no tienes un argumento, solo una lista.

Regla 6: un paso siguiente falsable

Termina con algo específico, pequeño y que pueda fallar. No con "hablemos". El cierre más fuerte nombra la condición de fracaso:

Si la clasificación es incorrecta, la lógica es incorrecta y la idea está muerta.

Una oferta que puede fallar es más creíble que una que no puede, especialmente ante una sala que ya ha sido convencida.

Regla 7: MECE, y reduce a las secciones que soportan carga

Las secciones no deben superponerse ni dejar un hueco en el argumento. Si dos secciones hacen el mismo punto, combínalas. Si una sección no respalda nada de lo que está arriba, elimínala.

Prueba aplicada del mismo documento: un caso de referencia no relacionado se encontraba en medio de una propuesta sobre priorización de pedidos. La nota del revisor: "el texto es aleatorio ... o va en el correo electrónico, o si va aquí, debe haber un contexto claro." Apoyaba una idea rectora diferente, por lo que pertenecía a un artefacto distinto. Se movió al correo de presentación y la página se acortó y fortaleció.

Lista de verificación antes de enviar

  1. La primera frase sustantiva es la recomendación, no los antecedentes ni una advertencia.
  2. Los encabezados se leen solos como un argumento completo.
  3. Hay una complicación declarada, idealmente aritmética.
  4. Las exclusiones están en una franja de escaneo o en una sección de cierre, nunca al inicio.
  5. Las secciones están numeradas y son MECE.
  6. El cierre es un paso siguiente específico y falsable.
  7. Nada en la página respalda una idea rectora diferente.

No cubierto aquí

Tono y registro: esta habilidad trata sobre el orden del argumento, no sobre la voz. Los límites de longitud para mensajes cortos a clientes, y los mecanismos de construcción y publicación de una página compartida, son asuntos separados.

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 relacionados