Community코딩 & 개발github.com

getedgehq/top-down-comms

클라이언트를 위한 탑다운 커뮤니케이션 스킬입니다. 가장 먼저 와야 할 것이 무엇인지, 그리고 그 이유를 알려줍니다.

top-down-comms란 무엇인가요?

이 스킬은 기술 문서와 제안서의 논리적 구조를 최적화하는 방법을 제공합니다. Minto 피라미드 원칙을 바탕으로, 첫 번째 문장부터 핵심 답변을 제시하고, 각 섹션 제목이 결론을 전달하도록 함으로써 독자가 문서의 요점을 즉시 파악할 수 있게 합니다. Cursor, Claude Code, Codex 등 다양한 AI 어시스턴트에서 사용 가능하며, Git 기반 워크플로우와도 호환됩니다. 주요 규칙으로는 '지배적 생각을 먼저 배치', '액션 타이틀 사용', 'S-C-R 구조 적용', '예외 사항은 메타데이터로 처리', '섹션 번호 매기기', '반증 가능한 다음 단계 제시', 'MECE 원칙 준수' 등이 포함되어 있습니다. 이 스킬은 특히 법적, 전략적, 기술적 제안서 작성 시 흔히 발생하는 '방어적 서두'의 약점을 극복하도록 설계되었습니다.

지원 대상~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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

탑다운 클라이언트 커뮤니케이션

톤 스킬은 '어떻게 들리는지'를 알려줍니다. 이 스킬은 '무엇이 먼저 와야 하는지, 그리고 그 이유'를 알려줍니다. 완벽한 어조로 작성된 문서라도 논리가 뒤집혀 있으면 실패합니다.

이 스킬이 해결하려는 문제

세 번의 시각 검토를 통과한 제안서 페이지에서 한 검토자가 남긴 말: "훨씬 나아졌습니다. 하지만 스토리라인을 고치세요. 왜 이것부터 시작해야 하죠? 맥킨지 컨설턴트, BCG 컨설턴트, 그리고 탑다운 커뮤니케이션 관점에서 생각해보세요."

해당 페이지는 "소스 이미지의 자동 분석 없음" 으로 시작했습니다 — 범위 제외 사항이었죠. 여기에는 타당한 이유가 있었습니다. 수신자의 자체 전문가들이 기계 벤치마크를 이겼고, 책임 문제가 그들의 주요 반론이었기 때문입니다. 하지만 독자가 처음 접한 인상은 문서가 아닌 것에 대한 부인(disclaimer)이었고, 실제 제안 내용을 알기 위해 독자는 세 번째 섹션까지 읽어야 했습니다.

방어적 서두는 책임감 있어 보이지만 약하게 읽힙니다. 면책 조항을 앞에 두려는 본능이야말로 정확히 극복해야 할 본능입니다.

규칙 1: 지배적 생각(governing thought)이 먼저 온다

민토 피라미드. 첫 번째 실질적 문장은 답이어야 합니다. 배경도, 주제도, 면책 조항도 아니며, 그 아래 모든 내용이 이를 뒷받침합니다.

서두판정
"소스 이미지의 자동 분석 없음"제외 사항. 무엇이 아닌지를 말함.
"들어온 주문을 공헌이익 순으로 정렬"주제 레이블. 주제를 명명할 뿐 주장하지 않음.
"최대 가동률에서 문제는 얼마나 많은 주문을 수락하느냐가 아니라 어떤 주문을 수락하느냐입니다. 제안: 들어오는 모든 요청을 예상 공헌이익으로 자동 점수화하십시오."답. 추천 + 이유, 페이지 첫 번째에 배치.

테스트: 독자가 첫 문장만 읽고 멈춰도, 당신이 원하는 행동을 알 수 있습니까? 그렇지 않다면 첫 문장을 다시 쓰십시오.

규칙 2: 주제 레이블이 아닌 액션 타이틀

모든 섹션 제목은 그 결론을 명시해야 합니다. 제목만 읽은 독자가 전체 논증을 이해할 수 있어야 합니다. 이것이 가장 효과가 크면서도 가장 자주 생략되는 방법입니다.

주제 레이블 (약함)액션 타이틀 (옳음)
배경병목은 수요가 아니라 생산 능력이다
점수 산정 로직다섯 가지 기준이 주문의 실제 가치를 결정한다
예시같은 아침, 같은 노력, 다른 마진의 두 요청
테스트아무것도 구축하기 전에 한 시간 안에 확인 가능
노력실행까지 며칠 소요

제목만 읽기 테스트. 본문을 없애고 제목을 순서대로 읽어보십시오. 제목들이 일관된 논증을 형성하지 않는다면 구조가 잘못된 것이며, 아무리 훌륭한 본문도 구제할 수 없습니다.

규칙 3: 상황-복잡성-해결책(S-C-R), 그리고 복잡성이 핵심이다

상황(Situation, 양측이 사실이라고 동의하는 것) → 복잡성(Complication, 왜 그 상태로 둘 수 없는지) → 해결책(Resolution, 당신의 추천). 대부분의 약한 문서는 상황과 해결책만 있고 복잡성이 없어서, 추천이 동기 부여되지 않은 채 도착합니다.

복잡성은 가능하면 산술적으로 표현해야 합니다: "주문을 마진 순서가 아닌 도착 순서대로 처리한다면, 마진이 얇은 주문을 수락할 때마다 마진이 두꺼운 주문 하나를 놓치는 것입니다." 이는 독자가 확인할 수 있는 메커니즘이지, 받아들여야만 하는 주장이 아닙니다.

규칙 4: 제외 사항과 면책 조항은 메타데이터다

이들은 상단 근처의 훑어보기 영역(scan strip)이나 마지막 번호 섹션에 속합니다. 절대 첫 위치에 두지 말고, 추천보다 앞선 제목으로 두지 마십시오.

"한눈에 보기" 영역이 이 문제를 해결합니다: 지배적 생각 바로 아래에 있는 4칸 행입니다.

범위 내           범위 밖             데이터 출처            다음 단계
주문이             소스 이미지의        회계 내보내기,         20~30개 인보이스,
처리되는 순서      자동 분석            프로젝트 폴더 아님     약 1시간

제외 사항은 첫 화면에서 보이므로 아무도 '묻혀 있었다'고 주장할 수 없지만, 사과가 아닌 범위로 구성됩니다. 반론이 충분히 심각하다면 마지막에 별도 섹션을 할애하십시오.

규칙 5: 섹션에 번호를 매긴다

01, 02, 03. 컨설턴트들이 이렇게 하는 이유는 문서를 회의에서 참조 가능하게 만들기 때문입니다 ("02로 돌아가보죠"). 또한 섹션이 11개나 될 때 스스로 깨닫게 해줍니다. 11개라는 것은 당신이 논증이 아니라 목록만 가지고 있다는 뜻입니다.

규칙 6: 반증 가능한(falsifiable) 다음 단계 하나

구체적이고 작으며 실패할 수 있는 것으로 끝내십시오. "논의합시다"가 아닙니다. 가장 강력한 마무리는 '죽음의 조건'을 명명합니다:

순위가 잘못되면 로직이 잘못된 것이고, 아이디어는 죽은 것입니다.

실패할 수 있는 제안은 그렇지 않은 제안보다 더 신뢰할 만합니다. 특히 이미 설득당한 청중 앞에서는 더욱 그렇습니다.

규칙 7: MECE, 그리고 하중을 견디는(load-bearing) 섹션만 남긴다

섹션은 서로 겹치지 않아야 하며 논증에 구멍을 남기지 않아야 합니다. 두 섹션이 같은 요점을 말한다면 병합하십시오. 위의 어떤 것도 지원하지 않는 섹션이 있다면 삭제하십시오.

동일 문서의 실제 테스트 사례: 주문 우선순위 지정에 관한 제안서 중간에 관련 없는 참조 사례가 있었습니다. 검토자의 메모: "텍스트가 무작위적입니다... 이메일에 넣거나, 여기에 두려면 명확한 맥락이 있어야 합니다." 이는 다른 지배적 생각을 지원했기 때문에 다른 문서에 속했습니다. 커버링 이메일로 옮겨지면서 페이지는 더 짧아지고 강력해졌습니다.

배포 전 체크리스트

  1. 첫 번째 실질적 문장은 배경이나 면책 조항이 아닌 추천이다.
  2. 제목만 읽어도 완전한 논증을 이룬다.
  3. 명시된 복잡성(가급적 산술적)이 있다.
  4. 제외 사항은 훑어보기 영역 또는 마지막 섹션에 있으며, 절대 첫머리에 있지 않다.
  5. 섹션에 번호가 매겨져 있고 MECE를 만족한다.
  6. 마무리는 하나의 구체적이고 반증 가능한 다음 단계이다.
  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

관련 스킬