pyramid-structuring
Structure analysis and presentations using the Pyramid Principle with SCQA and MECE frameworks
Best use case
pyramid-structuring is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Structure analysis and presentations using the Pyramid Principle with SCQA and MECE frameworks
Teams using pyramid-structuring should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/pyramid-structuring/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How pyramid-structuring Compares
| Feature / Agent | pyramid-structuring | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Structure analysis and presentations using the Pyramid Principle with SCQA and MECE frameworks
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Pyramid Principle Structuring ## Overview The Pyramid Principle Structuring skill provides specialized capabilities for structuring analysis and presentations using Barbara Minto's Pyramid Principle. This skill enables clear, compelling communication through logical structuring, SCQA format, MECE grouping, and executive-ready storyline development. ## Capabilities ### SCQA Format Structuring - Structure arguments in SCQA format (Situation, Complication, Question, Answer) - Create compelling opening hooks - Build logical narrative flow - Generate executive-ready introductions ### MECE Grouping - Apply MECE grouping to analysis points (Mutually Exclusive, Collectively Exhaustive) - Validate logical groupings - Identify gaps and overlaps - Reorganize content for clarity ### Executive Summary Generation - Generate executive summaries from detailed analysis - Apply "answer first" principle - Create one-page executive briefs - Synthesize key insights and recommendations ### Storyline Flow Creation - Create storyline flow for presentations - Build logical argument chains - Connect insights to recommendations - Design persuasive narrative arcs ### Logical Structure Validation - Validate logical structure of arguments - Check for proper grouping and ordering - Identify logical fallacies - Verify conclusion support ### Pyramid Diagram Generation - Generate pyramid structure diagrams - Visualize argument hierarchy - Show supporting points at each level - Create visual summaries ### Slide Storyboarding - Create slide-by-slide storyboards - Define key message per slide - Outline supporting content - Design visual layout recommendations ## Usage ### Structure with SCQA ``` Structure this analysis using SCQA format: [Analysis content] Create a compelling introduction and logical flow. ``` ### Apply MECE Grouping ``` Apply MECE grouping to these points: [List of analysis points] Reorganize into mutually exclusive, collectively exhaustive groups. ``` ### Generate Executive Summary ``` Generate an executive summary from this detailed analysis: [Detailed analysis content] Apply answer-first principle and limit to one page. ``` ### Create Presentation Storyline ``` Create a presentation storyline for this recommendation: [Recommendation and supporting analysis] Design slide-by-slide storyboard with key messages. ``` ## Process Integration This skill integrates with the following business analysis processes: - executive-presentation.js - Core presentation structuring - business-case-development.js - Business case communication - hypothesis-driven-analysis.js - Analysis structuring - consulting-engagement-planning.js - Client communication ## Dependencies - Document structuring algorithms - Presentation templates - Pyramid diagram generation - Logical validation rules ## Pyramid Principle Reference ### SCQA Framework | Element | Purpose | Question Answered | |---------|---------|-------------------| | Situation | Set context | What do we all agree on? | | Complication | Create tension | What changed or went wrong? | | Question | Focus attention | What should we do about it? | | Answer | Provide solution | Here's what we recommend | ### MECE Principles **Mutually Exclusive**: No overlap between groups - Each item belongs to only one category - Categories are clearly distinct - No double-counting **Collectively Exhaustive**: Nothing missing - All possibilities are covered - No gaps in the logic - Complete coverage of the topic ### Pyramid Structure Rules 1. **Start with the answer**: Lead with your conclusion 2. **Group and summarize**: Organize supporting points 3. **Logically order**: Use deductive or inductive logic 4. **Apply MECE**: Ensure logical grouping ### Logical Ordering Options | Order Type | When to Use | Example | |------------|-------------|---------| | Time | Sequential events | Phase 1, Phase 2, Phase 3 | | Structure | Organizational units | Region A, Region B, Region C | | Importance | Prioritized items | Critical, Important, Nice-to-have | | Process | Workflow steps | Input, Process, Output | | Comparison | Evaluating options | Option A vs B vs C | ### Deductive vs Inductive Arguments **Deductive** (Argument): - Major premise (rule) - Minor premise (case) - Conclusion (result) **Inductive** (Grouping): - Group similar ideas - Summarize the group - Draw conclusion from pattern ### Slide Storyboard Template ``` Slide Title: [Action title - key message] Key Message: [One sentence takeaway] Supporting Points: - [Point 1] - [Point 2] - [Point 3] Visual: [Chart/diagram recommendation] Transition: [Link to next slide] ``` ### Executive Summary Structure 1. **Headline**: Answer in one sentence 2. **Context**: Brief situation/complication 3. **Key findings**: 3-5 bullet points (MECE) 4. **Recommendation**: Clear call to action 5. **Next steps**: Immediate actions required
Related Skills
process-builder
Scaffold new babysitter process definitions following SDK patterns, proper structure, and best practices. Guides the 3-phase workflow from research to implementation.
babysitter
Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)
yolo
Run Babysitter autonomously with minimal manual interruption.
user-install
Install the user-level Babysitter Codex setup.
team-install
Install the team-pinned Babysitter Codex workspace setup.
retrospect
Summarize or retrospect on a completed Babysitter run.
resume
Resume an existing Babysitter run from Codex.
project-install
Install the Babysitter Codex workspace integration into the current project.
plan
Plan a Babysitter workflow without executing the run.
observe
Observe, inspect, or monitor a Babysitter run.
model
Inspect or change Babysitter model-routing policy by phase.
issue
Run an issue-centric Babysitter workflow.