Minto Pyramid
Restructures writing into Barbara Minto's Pyramid Principle — conclusion first, then grouped reasons, then evidence — and audits an existing draft's logic against Minto's rules. Use when the user is writing, or has drafted, something that asks a reader to accept a judgment or make a decision: a recommendation, proposal, exec summary, memo, review with a verdict, or status update with an ask; or when a draft buries its point or narrates the process instead of the finding. Not for incident timelines, runbooks, tutorials, notes, or writing where chronology is the content.
Install
npx skills add millwright-labs/minto-pyramid-skill --skill minto-pyramidgit clone --depth 1 https://github.com/millwright-labs/minto-pyramid-skill.git /tmp/minto-pyramid-skill
mkdir -p ~/.claude/skills
cp -r /tmp/minto-pyramid-skill/. ~/.claude/skills/minto-pyramidPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Minto Pyramid **Three rules that override everything below this line:** 1. **If the user did not ask you to change the document, do not change it.** Say what you noticed in two sentences and ask. 2. **If it is a timeline, runbook, tutorial, or note, do not impose this structure on it.** Formatting they explicitly asked for is fine; hoisting a conclusion above the sequence is not. 3. **Never add a fact, figure, section or "lesson" the source does not contain** — including arithmetic you performed on the source's numbers. ## Step 0 — Gate. Do this before anything else. **Question 1: Does this document ask its reader to accept a judgment or make a decision?** Yes for recommendations, proposals, verdicts, analyses with a conclusion, updates carrying an ask. No for timelines, runbooks, procedures, tutorials, notes, descriptions, thanks, apologies, and anything whose value is the sequence of events. **No → say so in one line and stop.** Do not restructure it. > "This isn't a pyramid case — it's an incident timeline, and time order is the right order here. Want me to tighten it as-is instead?" **Question 2: Did the user ask you to change it?** If they named the skill, asked for a restructure, or asked you to **write** the document — apply it now. No preamble, no asking. Otherwise — they shared **their own** draft to look at, or it came up sideways — your entire response is **two sentences**:
Details
- Skill name
minto-pyramid- Repository
- millwright-labs/minto-pyramid-skill
- License
- MIT
- Repo updated
- 16 August 2026
FAQ
What does the Minto Pyramid skill do?
Restructures writing into Barbara Minto's Pyramid Principle — conclusion first, then grouped reasons, then evidence — and audits an existing draft's logic against Minto's rules. Use when the user is writing, or has drafted, something that asks a reader to accept a judgment or make a decision: a recommendation, proposal, exec summary, memo, review with a verdict, or status update with an ask; or when a draft buries its point or narrates the process instead of the finding. Not for incident timelines, runbooks, tutorials, notes, or writing where chronology is the content.
How do I install the Minto Pyramid skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add millwright-labs/minto-pyramid-skill --skill minto-pyramid. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Minto Pyramid popular?
It lives in millwright-labs/minto-pyramid-skill, which has 89 GitHub stars and 9 forks.
Related skills
Gc Muted Zine Poster V0 1
90moonlin1213/muted-zine-poster-v01
Generate Muted Zine Poster v0.1 poetic paper-poster prompts and the matching generated image. Use when the user gives a theme, sentence, object, mood, article idea, photo, or content brief and wants a quiet Japanese/Korean zine-like editorial poster with large negative space, aged paper texture, experimental typography, and a restrained muted palette without high-chroma color blocks. This is the low-saturation sibling of gc-minimal-zine-poster-v0-1.
Technical Proposal Expert
88yanhaoluo0/technical-proposal-expert-writing-skill
MUST be used when writing, drafting, or polishing Chinese formal documents. Use when the user asks for 技术标书, 投标, 招标, 技术方案, 投标书, 方案设计报告, 系统设计说明, 测试报告, 测试总结, 工作周报, 周总结, or unspecified 公文/方案/文档. Also use when the document type is unclear and a writing scene must be chosen first.
Developer Documentation
81NateBJones-Projects/developer-documentation-skill
Create, restructure, or maintain accurate developer documentation for software, tools, automations, packages, APIs, SDKs, CLIs, installations, migrations, operations, and troubleshooting. Use when the user asks for a README, overview, quickstart, tutorial, how-to guide, concept page, reference, API or CLI documentation, installation guide, runbook, migration guide, release notes, troubleshooting page, or a complete documentation set.
Graphify Novel
79Anshler/graphify-novel
Novel writing assistant — init bible from premise, review passages for consistency, update the plot tree, manage threads and character arcs
Typefully
63typefully/agent-skills
Create, schedule, and manage social media posts via Typefully. ALWAYS use this skill when asked to draft, schedule, post, or check tweets, posts, threads, or social media content for Twitter/X, LinkedIn, Threads, Bluesky, Mastodon, or Substack Notes, or when the user drops a Typefully draft URL such as https://typefully.com/?a=<social_set_id>&d=<draft_id>.
Cn Law Hub
87ZongziForu/cn-law-hub
用于查询、检索、核验、下载、导出、批量采集中国官方法律法规、规章、条约和具体法条。Use this skill aggressively when the user asks to 查法律、查法规、查条例、查规章、查条约、查法条、查第几条、找法律依据、引用法律依据、核验现行有效、判断是否废止/已修改/尚未生效、下载法规全文、导出法规目录、批量下载法规文件、按关键词检索具体法条、展开法条分析,或在中国法律咨询、案例分析、合规审查、合同审查、劳动争议、行政法分析、公司合规、数据合规、政策研究中需要调用、核验或引用中国现行有效法律法规原文作为依据。Trigger also when phrases such as 依法、依规、依照法律规定、法律法规 imply a need to verify specific statutory authority or article-level text. Covers 国家法律法规数据库 (flk.npc.gov.cn), 国家规章库 (gov.cn), 外交条约库 (treaty.mfa.gov.cn), 国务院政策文件库 (sousuo.www.gov.cn), 司法部行政法规库 (xzfg.moj.gov.cn), 党内法规库 (12371.cn), 国防部法规文库 (mod.gov.cn), 税务法规库 (fgk.chinatax.gov
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.