Agent skill

Top Down Memo

by sruthir28 in sruthir28/enterprise-ai-skills

Answer-first writing using the Minto Pyramid Principle. An agent skill from sruthir28/enterprise-ai-skills.

MITAuto-check passed

Install Top Down Memo

skills CLI
$ npx skills add sruthir28/enterprise-ai-skills --skill top-down-memo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sruthir28/enterprise-ai-skills top-down-memo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sruthir28/enterprise-ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/top-down-memo .claude/skills/top-down-memo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
top-down-memo
GitHub stars
148
Token cost
~2.4k tokens
SKILL.md length
1,159 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Answer-first writing using the Minto Pyramid Principle. An agent skill from sruthir28/enterprise-ai-skills.

  • Works in 5 steps: The answer. What do you actually think?… → Reader. Exec / peer / team. Changes… → The decision the reader needs to make… → …
  • You have a recommendation
  • SKILL.md covers Why people don't do this…, Design choices, The pyramid structure and Output format, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Top Down Memo is an agent skill from sruthir28/enterprise-ai-skills. Answer-first writing using the Minto Pyramid Principle. Lead with the conclusion, then 2–4 MECE supporting arguments, then evidence under each. Use whenever you have a recommendation, finding, or assessment to communicate in writing — memos, emails to execs, Slack updates that need to land, briefing docs. Different from the Decision Memo Builder (which is a specific 1-page decision artifact); this is the general writing method.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Slack. The repository describes itself as: Open-source AI skills for enterprise professionals. McKinsey consulting frameworks, PM workflows, and practical tools. Currently for Claude, expanding to other LLMs. The licence is MIT.

When your agent uses it

  • You have a recommendation
  • Assessment to communicate in writing — memos
  • Emails to execs
  • Slack updates that need to land

Example prompts

  • “/top-down-memo”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. The answer. What do you actually think? If unclear, the memo isn't ready — use Synthesis or Decision Memo first.
  2. Reader. Exec / peer / team. Changes vocabulary and depth.
  3. The decision the reader needs to make (if any).
  4. The 2–4 reasons you believe the answer. If you can't list them, you haven't synthesized.
  5. Evidence for each reason. Specific, sourced.

What it can do on your machine

Read from SKILL.md and the folder at commit ae8fe60. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Top Down Memo loads about 2.4k tokens when it runs. Until then it costs about 111 tokens; SKILL.md has 1,159 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sruthir28/enterprise-ai-skills at commit ae8fe60, republished under its MIT licence (© sruthir28). 1,159 words, ~2,372 tokens.

Download SKILL.mdSave it as .claude/skills/top-down-memo/SKILL.md (or your agent's skills folder).
name
top-down-memo
description
Answer-first writing using the Minto Pyramid Principle. Lead with the conclusion, then 2–4 MECE supporting arguments, then evidence under each. Use whenever you have a recommendation, finding, or assessment to communicate in writing — memos, emails to execs, Slack updates that need to land, briefing docs. Different from the Decision Memo Builder (which is a specific 1-page decision artifact); this is the general writing method.

Top-Down Memo

The McKinsey writing rule: lead with the answer. Chronological narratives ("first we did X, then Y, then Z, and concluded W") are how thinking happens, not how communication should land. Top-down inverts the order — conclusion first, then the structure that supports it, then the evidence.

This is also called BLUF (Bottom Line Up Front) in military writing and Minto Pyramid in consulting. Same idea. Different name.

The test: can the reader stop after the first paragraph and still know what you think and what you want? If yes, top-down. If they need to read to the end to find the answer, you wrote a story.


Why people don't do this naturally

The way you thought about something is the opposite of how the reader needs to hear it.

You (writer)Reader
Gathered data → found patterns → drew conclusionWants the conclusion → then patterns → then data only if they push back

Chronological narrative is easier to write because it matches your discovery path. It's harder to read because the reader doesn't know where you're going. Reversing the order is unnatural but obviously correct.


Design choices

  • Lead is the answer, not the setup. The first sentence states what you think. The reader can stop here.
  • 2–4 supporting arguments. Rule of 3 is best. >4 means you haven't synthesized; <2 means it's a one-liner, not a memo.
  • MECE at the argument level. The supports should not overlap and should jointly defend the lead.
  • Evidence under each argument, not in a separate section. Reader skims to the argument they doubt, then drops down for proof.
  • Background last (if at all). Most "background" sections exist because the writer felt anxious about jumping to the answer. Cut.
  • One memo, one answer. If you have two recommendations, write two memos.

The pyramid structure

                    [LEAD]
                  The answer.
                One sentence.
                      │
       ┌──────────────┼──────────────┐
       │              │              │
   [ARG 1]        [ARG 2]        [ARG 3]
   Because…       Because…       Because…
       │              │              │
   • evidence      • evidence      • evidence
   • evidence      • evidence      • evidence
   • evidence      • evidence      • evidence

The three arguments must jointly support the lead — if all three are true, the lead must be true. Cut anything that doesn't ladder up.


Output format

[LEAD — one sentence with the answer]

[OPTIONAL: 1 sentence on the ask or so-what if the lead is a finding]

ARGUMENT 1: [Headline claim that supports the lead]
• [Evidence: specific data, source]
• [Evidence: specific data, source]
• [Evidence: specific data, source]

ARGUMENT 2: [Headline claim]
• [Evidence]
• [Evidence]
• [Evidence]

ARGUMENT 3: [Headline claim]
• [Evidence]
• [Evidence]
• [Evidence]

[OPTIONAL: Risks or open questions — max 3 bullets]

[OPTIONAL: Background / context — only if reader genuinely lacks it]

Inputs needed (interview if missing)

  1. The answer. What do you actually think? If unclear, the memo isn't ready — use Synthesis or Decision Memo first.
  2. Reader. Exec / peer / team. Changes vocabulary and depth.
  3. The decision the reader needs to make (if any).
  4. The 2–4 reasons you believe the answer. If you can't list them, you haven't synthesized.
  5. Evidence for each reason. Specific, sourced.

Process

  1. Write the lead in one sentence. If it takes two, you have two leads — split.
  2. List the 2–4 arguments. Test: if all true, is the lead provably true?
  3. MECE-check the arguments. Overlapping → merge. Missing a defense → add. Independent of lead → cut.
  4. Stack evidence under each. 2–4 bullets, specific and sourced. No "many people" or "it's clear that."
  5. Read top-to-bottom and test the stop-anywhere principle: can the reader stop at the lead alone, the lead + arguments, or the full memo, and walk away with the right takeaway at each level?
  6. Cut everything that doesn't ladder up. Especially: backstory, process notes, "by way of context."

Worked example 1: Memo to CEO on potential acquisition

LEAD: We should not acquire Vega Labs. Their tech is real but the cultural fit and price preclude a deal that creates value.

(If we want to revisit in 6 months at a 40% lower valuation and after their senior team has stabilized, the math could work — happy to set that revisit on the calendar.)

ARGUMENT 1: The price ($380M) is 2.4x what the asset is worth on a standalone basis.

  • Vega's TTM ARR is $22M growing 45% — implied 17x ARR multiple at ask vs. 7x median for our peer group (Q1 2026 SaaS comps, KeyBanc).
  • DCF at our cost of capital (12%) and the founders' own projections (which we discount 30%) supports $160M.
  • No realistic synergy story closes the $220M gap. Closest is cross-sell to our 4,200 customers; sensitivity says max $35M NPV.

ARGUMENT 2: 60% of their senior eng team is at <12-month vest cliff and is the actual asset.

  • 7 of 12 senior engineers vest between Q3 FY26 and Q1 FY27.
  • Two of the three named co-founders have publicly stated (podcasts, Q4 2025) that they want to "do another zero-to-one."
  • Acquirer history: 4 of the last 5 startups acquired by similar companies in our space lost >50% of senior eng within 18 months.

ARGUMENT 3: The integration risk is concentrated in the part of our stack we cannot afford to break.

  • Vega's product would have to integrate into our billing platform, which carries 92% of revenue and had two P0 incidents in Q4.
  • Their stack is Rust + custom DB; ours is Go + Postgres. Re-platforming estimate: 9–12 engineer-years.
  • The CTO's own pre-LOI risk memo flagged this as "non-trivial and likely to slip ≥6 months." Nothing has changed since.

RISKS OF NOT ACQUIRING

  • A competitor (likely Brava) buys them within 6 months and we lose distribution leverage. Mitigation: deepen our own roadmap on this surface area; we've already greenlit Q2 investment.
  • Brand signal that we're "passing on AI." Mitigation: we're acquiring [other target] this quarter — net story is selectivity, not absence.

(No background section needed — you've been in every Vega meeting since Jan.)


Show full SKILL.md (306 more words)Show less

Worked example 2: Slack message to a peer that needs to land

TL;DR: I think we should kill the Pro tier and merge everything into Team.

Three reasons:
1. Pro is <8% of revenue and 40% of pricing-page complexity (data in #pricing-experiments thread)
2. Every Pro customer we've talked to (n=14 in Q1) would happily move to Team at the same price
3. We're about to add 4 new add-ons that won't fit on a 3-tier page — collapsing now buys us room

Risk: ~30 legacy Pro accounts on a grandfathered price. Easy to migrate — I have the script.

Want to align before Friday's pricing review?

That's a top-down Slack message. Lead → reasons → risk → ask. ~120 words. The reader can stop after line 1 and still know what to do.


Common mistakes to avoid

  • Burying the lead. "Over the last 6 weeks, the team explored three options, and after careful consideration..." Cut. Lead with the answer.
  • "As you know" / "to provide context" preambles. If the reader knows, don't tell them. If they don't, the evidence will surface it.
  • Topic-shaped arguments. "Pricing" is a topic. "Pricing is 2.4x the standalone value" is an argument. Argument = claim, not subject.
  • Evidence that doesn't defend the argument above it. Common when copy-pasted from earlier drafts. Each bullet should clearly serve the headline.
  • More than 4 arguments. You haven't synthesized. Go back to Synthesis skill.
  • Recommendation hiding in "considerations." Decision-averse hedging. Recommend, or don't write the memo.

When to use

  • Any written communication where you have a recommendation or finding
  • Emails to executives
  • Slack messages that need a yes/no response
  • Briefing docs and pre-reads
  • Status updates that should drive a decision
  • Internal blog posts / wiki pages with a take

When NOT to use

  • Genuinely exploratory thinking ("here's what I'm noodling on") — narrative form is fine
  • Personal narratives, retrospectives, postmortems where chronology matters
  • Decision artifacts that need a formal structure — use Decision Memo Builder instead
  • Status updates with no recommendation — just use a clean list

Pairs well with

  • Synthesis — synthesis output (3 insights with so-whats) maps directly to top-down (lead = overall recommendation, insights = arguments)
  • Decision Memo Builder — top-down is the general method; Decision Memo is the constrained 1-page form for yes/no calls
  • McKinsey Critic — run the draft through the critic to catch buried leads and topic-shaped arguments
  • Storyline Builder — pyramid principle works for slide titles too; each slide title is a "lead" that the slide proves

© sruthir28, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in top-down-memo of sruthir28/enterprise-ai-skills.

Open the folder on GitHubat commit ae8fe60

Compare with similar skills

Top Down Memo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Top Down Memo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Top Down Memo this skillsruthir28/enterprise-ai-skills148—~2.4kAutomated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Slack GIF Creatoranthropics/skills180k29 repos~2kAutomated safety check: PassApache-2.0
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Electron App Automationvercel-labs/agent-browser44k5 repos~1.7kAutomated safety check: PassApache-2.0
Slack Browser Automationvercel-labs/agent-browser44k1 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Slack GIF Creator

    anthropics/skills

    Official

    Provides Slack size and frame limits, Python animation helpers and validators for building animated GIFs sized for emoji and messages.

    180k GitHub starsUsed in 29 repos~2k tokens
    Media & CreativeAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Electron App Automation

    vercel-labs/agent-browser

    Official

    Automates Electron desktop apps such as VS Code, Slack or Discord by connecting agent-browser to their Chrome DevTools Protocol port.

    44k GitHub starsUsed in 5 repos~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Slack Browser Automation

    vercel-labs/agent-browser

    Official

    Drives the Slack web app with the agent-browser CLI to check unread channels, search, read channel details and extract information, with screenshots as evidence.

    44k GitHub starsUsed in 1 repo~2.1k tokens
    Productivity & AutomationAuto-check passed
  • Composio

    ComposioHQ/composio

    Route and complete Composio work across Composio For You and Composio Platform.

    30k GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check passed

More from sruthir28/enterprise-ai-skills

All 14 skills in this repo
  • Storyline Builder

    sruthir28/enterprise-ai-skills

    McKinsey-style storyline framework for building presentation decks.

    148 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • AI Use Case Scorer

    sruthir28/enterprise-ai-skills

    Score and prioritize AI use cases for your own job. An agent skill from sruthir28/enterprise-ai-skills.

    148 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Decision Memo Builder

    sruthir28/enterprise-ai-skills

    Builds a 1-page decision memo (context → options → recommendation → risks → ask) enforcing McKinsey memo DNA — brutal brevity, SCP storyline clarity, decision-forcing output, evidence density.

    148 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Deck Pipeline

    sruthir28/enterprise-ai-skills

    Multi-agent pipeline that builds a polished presentation deck from a single topic.

    148 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Issue Tree Builder

    sruthir28/enterprise-ai-skills

    McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components.

    148 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Mckinsey Charts

    sruthir28/enterprise-ai-skills

    Generate McKinsey-style consulting charts as native python-pptx objects (editable inside PowerPoint).

    148 GitHub stars~999 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Top Down Memo

What does Top Down Memo do?

Answer-first writing using the Minto Pyramid Principle. An agent skill from sruthir28/enterprise-ai-skills. Top Down Memo is an agent skill from sruthir28/enterprise-ai-skills. Answer-first writing using the Minto Pyramid Principle.

When should I use Top Down Memo?

Top Down Memo fits situations like: you have a recommendation; assessment to communicate in writing — memos; emails to execs; slack updates that need to land.

How do I install Top Down Memo in Claude Code?

Run `npx skills add sruthir28/enterprise-ai-skills --skill top-down-memo -a claude-code`. Or copy the skill folder (top-down-memo in sruthir28/enterprise-ai-skills) into .claude/skills/top-down-memo in your project. Claude Code loads it when a task matches its description.

How do I install Top Down Memo in Codex?

Run `npx skills add sruthir28/enterprise-ai-skills --skill top-down-memo -a codex`. Or copy the skill folder (top-down-memo in sruthir28/enterprise-ai-skills) into .agents/skills/top-down-memo in your project. Codex loads it when a task matches its description.

Can I use Top Down Memo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sruthir28/enterprise-ai-skills --skill top-down-memo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/top-down-memo, .gemini/skills/top-down-memo, .github/skills/top-down-memo and .opencode/skills/top-down-memo in your project.

What does Top Down Memo need to run?

SKILL.md names no scripts, command-line tools or credentials: Top Down Memo is instructions for the agent only.

Does Top Down Memo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Top Down Memo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Top Down Memo use?

Top Down Memo is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Top Down Memo use?

About 2.4k tokens (SKILL.md is roughly 9.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Top Down Memo?

Skills that share tags, products or a category with Top Down Memo: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Slack GIF Creator (anthropics/skills, 180k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars) and Electron App Automation (vercel-labs/agent-browser, 44k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Top Down Memo?

sruthir28 (a GitHub user) maintains it in sruthir28/enterprise-ai-skills, which has 148 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 1, 2026.

Source: sruthir28/enterprise-ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.