pyramid-principle-core
Use when user asks about the Pyramid Principle, Minto, SCQA, MECE, governing thought, key line, vertical or horizontal logic, deductive or inductive reasoning, or answer-first structure. Canonical rule library for sibling writing skills.
tyroneross · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add tyroneross/pyramid-principle --skill pyramid-principle-coreAbout this skill
name: pyramid-principle-core description: Use when user asks about the Pyramid Principle, Minto, SCQA, MECE, governing thought, key line, vertical or horizontal logic, deductive or inductive reasoning, or answer-first structure. Canonical rule library for sibling writing skills.
Pyramid Principle Core
Purpose
Supply the canonical structural rules shared by every skill in this plugin. This skill explains and governs the framework. It does not draft or audit a finished artifact.
Source material: Barbara Minto, The Pyramid Principle (2009 revised edition). Verified quotations and page citations live in ${CLAUDE_PLUGIN_ROOT}/docs/source-anchors.md.
Route the Request
Load this skill for any Pyramid Principle structure or storyline task. When the task also uses sources, facts, or data, pyramid-source-integrity clears those claims first. Hand off when:
- the user wants fact checking, source validation, or data handling →
pyramid-source-integrity - the user wants an email, memo, executive summary, one-pager, BLUF, Slack update, or status note →
pyramid-short-form - the user wants a report, brief, proposal, or multi-section document →
pyramid-long-form - the user wants a deck or presentation storyline →
pyramid-presentation - the user wants existing writing diagnosed →
pyramid-audit
Structural Contract for Generated Output
Every sibling skill applies these rules before its medium-specific guidance:
- The agent states the main answer before its supporting points. If the reader cannot understand the answer without context, the agent gives only the context required to understand it, then states the answer before evidence or detail.
- The agent groups peers only when they answer the same parent question and perform the same logical role. It groups reasons with reasons, evidence with evidence, steps with steps, findings with findings, and risks with risks. Different topics may remain peers when one accurate role label describes every point.
- The agent treats counts and positions as format defaults, not correctness tests. It adjusts them to the reader, medium, evidence, and complexity while preserving answer-first structure and valid grouping.
- The agent uses examples as structural patterns, not task content. It does not copy an example's names, facts, scenario, terminology, or conclusion unless the user supplied them for the current task.
- The agent returns the requested artifact by default. It does not include framework labels, drafting notes, assumptions, or self-check commentary unless the user requests them or unresolved ambiguity prevents a reliable artifact.
pyramid-source-integrity separately owns fact checking, source validation, calculations, data scope, source locators, and confidence. The structural layer applies the drafting action defined by the confidence level but does not assign, reclassify, or strengthen confidence or claims.
Direct Language and Logical Flow
Apply these rules from the governing thought down to each sentence:
- Give each sentence one job. State one main claim per sentence. Split a sentence when two claims require different support or answer different questions.
- Name the actor and action. Prefer
[specific actor] [active verb] [specific outcome]over vague nouns, passive constructions, nominalizations, or weak verbs. WriteLegal approved the contract, notApproval of the contract was completed. - Use evidence instead of decoration. Replace vague adjectives and adverbs with validated measures when the source provides them. Treat evaluative modifiers and causal verbs as claims: keep them only when evidence supports their exact meaning. If no measure exists, use a precise factual description or remove the modifier; never invent data to make the sentence sound specific.
- Open with the sentence's logical subject. Lead with the actor for accountability, the result for an outcome, the cause for a diagnosis, the metric when evidence leads, or the contrast for a tradeoff.
- Connect given information to new information. Begin each sentence with a term or result the reader already knows, then end with the new point. Make the next sentence pick up that point when it continues the same line of thought.
- Preserve key terms through the hierarchy. A child claim repeats or precisely resolves the parent term it supports. Do not swap in decorative synonyms that make the reader infer whether two terms mean the same thing.
- Make bullets parallel and explicit. Each peer bullet states a complete claim, exposes the same logical role, and uses a consistent grammatical pattern. Prefer a specific noun plus an active verb.
- Show the real connection. Use
because,therefore,however, or sequence terms only when they state the actual relationship. A connector cannot repair missing evidence or a broken inference.
Three Rules of a Valid Pyramid
Every grouping must satisfy all three rules.
1. The parent summarizes its children
The parent is a substantive claim that the points below collectively prove, explain, or support. It is not a topic or container label. The governing thought is the apex claim, and every lower level directly supports the claim above it. (minto-p5-pyramid-sorting)
2. Peers perform the same logical role
Every peer answers the same parent question and belongs to one named kind. The agent tests the parent question and role before separating different topics. A set fails only when no accurate parent question and role label describes every peer. (minto-p5-pyramid-sorting, minto-p96-mece)
3. Peers follow one logical order
The agent chooses the order that matches what the set represents and does not mix order rules within one peer set. (minto-p5-pyramid-sorting)
Four Logical Orders
- Deductive: Each point derives from the prior point and ends in a conclusion.
- Chronological: Steps or events follow time or pro