getedgehq/top-down-comms

Esta skill ensina a estruturar comunicações com clientes de forma hierárquica, colocando a ideia principal primeiro, eliminando ambiguidades e evitando introduções defensivas que enfraquecem o argumento.

O que é top-down-comms?

Esta skill, baseada nos princípios de consultoria estratégica (Minto, McKinsey, BCG), foca em estruturar documentos e mensagens para clientes de modo que a conclusão apareça primeiro, seguida por suporte lógico. Ela aborda falhas comuns como abertura com exclusões ou pano de fundo, que confundem o leitor. As regras incluem: colocar o pensamento governante na primeira frase, usar títulos de ação (não rótulos de tópico), aplicar a estrutura Situação-Complicação-Resolução (SCR), tratar exclusões como metadados em faixa de varredura, numerar seções, terminar com um próximo passo falsificável e garantir que as seções sejam MECE (Mutualmente Exclusivas e Coletivamente Exaustivas). A skill é útil para qualquer profissional que precise redigir propostas, relatórios ou e-mails claros e persuasivos, independentemente da plataforma (Claude Code, Cursor, etc.). Ela não cobre tom ou registro, mas sim a ordem e a lógica do argumento.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Comunicação descendente com o cliente

As skills de tom dizem como soa. Esta diz o que vem primeiro e porquê. Um documento perfeitamente articulado com um argumento invertido ainda falha.

A falha que esta skill existe para impedir

Um revisor, numa página de proposta que já tinha passado por três rodadas visuais: "Isto está melhor, mas corrige a história. Porque é que devemos começar com isto? Pensa nisto da perspetiva de um consultor da McKinsey, um consultor da BCG, e comunicação descendente."

A página abria com "Nenhuma análise automatizada das imagens de origem" — uma exclusão de âmbito. Estava lá por uma boa razão: os próprios especialistas do destinatário tinham batido um benchmark de máquina, e a responsabilidade era a objeção ativa deles. Mas a primeira impressão do leitor era uma declaração sobre algo que o documento não era, e eles tinham de chegar à secção três antes de saber o que estava realmente a ser proposto.

Aberturas defensivas parecem responsáveis e leem-se como fracas. O instinto de colocar a ressalva à frente é exatamente o instinto a anular.

Regra 1: o pensamento governante vem primeiro

A pirâmide de Minto. A primeira frase substantiva é a resposta, não o contexto, não o tópico, não a ressalva. Tudo o que está abaixo suporta-a.

AberturaVeredito
"Nenhuma análise automatizada das imagens de origem."Exclusão. O que não é.
"Ordenar as encomendas recebidas pela margem de contribuição"Rótulo de tópico. Nomeia um assunto, não afirma nada.
"Em plena capacidade, a questão não é quantas encomendas aceita, mas quais. A proposta: pontuar automaticamente cada pedido recebido pela margem de contribuição esperada."A resposta. Recomendação + razão, logo na primeira página.

Teste: se o leitor parar depois da primeira frase, sabe o que quer que ele faça? Se não, reescreva a primeira frase.

Regra 2: títulos de ação, não rótulos de tópico

Cada título de secção declara a sua conclusão. Um leitor que leia apenas os títulos deve obter o argumento completo. Esta é a jogada de maior alavancagem e a mais frequentemente ignorada.

Rótulo de tópico (fraco)Título de ação (correto)
ContextoO gargalo é a capacidade, não a procura
Lógica de pontuaçãoCinco critérios decidem o valor real de uma encomenda
ExemploDois pedidos na mesma manhã, mesmo esforço, margem diferente
O testeVerificável numa hora, antes de construir algo
EsforçoAlguns dias para implementação

O teste só de títulos. Elimine o corpo. Leia os títulos em sequência. Se não formarem um argumento coerente, a estrutura está errada e nenhuma quantidade de texto corpo a salvará.

Regra 3: SCR, e a complicação é o trabalho todo

Situação (o que ambos os lados concordam ser verdade) → Complicação (porque não pode permanecer assim) → Resolução (a sua recomendação). A maioria dos documentos fracos têm situação e resolução, mas nenhuma complicação, pelo que a recomendação chega sem motivação.

A complicação deve ser aritmética sempre que possível: "Se processar as encomendas por ordem de chegada em vez de por margem, cada encomenda de margem baixa que aceitar custa-lhe uma de margem alta." Isto é um mecanismo que o leitor pode verificar, não uma afirmação que ele deve aceitar.

Regra 4: exclusões e ressalvas são metadados

Pertencem a uma faixa de varredura perto do topo ou a uma secção numerada no final. Nunca na posição de abertura, nunca como título antes da recomendação.

A faixa "num relance" resolve isto: uma linha de quatro células diretamente abaixo do pensamento governante.

EM ÂMBITO          FORA DE ÂMBITO       FONTE DE DADOS         PRÓXIMO PASSO
A ordem em que    Análise               Exportações            20 a 30 faturas,
os pedidos        automatizada         contabilísticas,       cerca de 1 hora
são processados   das imagens           não pastas de
                  de origem             projeto

A exclusão é visível no primeiro ecrã, pelo que ninguém pode alegar que foi enterrada, mas é enquadrada como âmbito em vez de desculpa. Dê-lhe uma secção completa no final se a objeção for suficientemente séria para merecer uma.

Regra 5: numerar as secções

01, 02, 03. Os consultores fazem-no porque torna um documento referenciável numa reunião ("volte ao 02"). Também o força a reparar quando tem onze secções, o que significa que não tem argumento, apenas uma lista.

Regra 6: um próximo passo falsificável

Termine com algo específico, pequeno e capaz de falhar. Não "vamos discutir". O fecho mais forte nomeia a condição de morte:

Se a ordenação estiver errada, a lógica está errada e a ideia está morta.

Uma oferta que pode falhar é mais credível do que uma oferta que não pode, especialmente para uma sala que já foi convencida.

Regra 7: MECE, e cortar para as secções estruturais

As secções não devem sobrepor-se e não devem deixar um buraco no argumento. Se duas secções fizerem o mesmo ponto, funda-as. Se uma secção não suportar nada acima dela, apaga-a.

Teste aplicado do mesmo documento: um caso de referência não relacionado estava no meio de uma proposta sobre priorização de encomendas. A nota do revisor: "o texto é aleatório... ou vai no e-mail, ou se fica aqui, tem de haver contexto claro." Suportava um pensamento governante diferente, pelo que pertencia a um artefacto diferente. Foi movido para o e-mail de apresentação e a página ficou mais curta e mais forte.

Lista de verificação antes de enviar

  1. A primeira frase substantiva é a recomendação, não o contexto ou uma ressalva.
  2. Os títulos lidos sozinhos formam um argumento completo.
  3. Existe uma complicação declarada, idealmente aritmética.
  4. As exclusões estão numa faixa de varredura ou numa secção de fecho, nunca na abertura.
  5. As secções são numeradas e MECE.
  6. O fecho é um próximo passo específico e falsificável.
  7. Nada na página suporta um pensamento governante diferente.

Não abordado aqui

Tom e registo: esta skill é sobre a ordem do argumento, não sobre a voz. Limites de comprimento para mensagens curtas a clientes, e os mecanismos de construção e publicação de uma página partilhada, são preocupações separadas.

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

Habilidades Relacionadas