Agent skill

Meta Structured Problem

by asgard-ai-platform in asgard-ai-platform/skills

Apply structured problem-solving using MECE principle, issue trees, hypothesis-driven approach, and the Pyramid Principle.

MITAuto-check passed

Install Meta Structured Problem

skills CLI
$ npx skills add asgard-ai-platform/skills --skill meta-structured-problem -a claude-code

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

GitHub CLI
$ gh skill install asgard-ai-platform/skills meta-structured-problem --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/asgard-ai-platform/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/meta-structured-problem .claude/skills/meta-structured-problem && 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
meta-structured-problem
GitHub stars
241
Token cost
~1.4k tokens
SKILL.md length
459 words
Files
4 (incl. references)
Skills in repo
209
Repo updated
First seen
Licence
MIT

At a glance

Apply structured problem-solving using MECE principle, issue trees, hypothesis-driven approach, and the Pyramid Principle.

  • Works in 5 steps: Form an initial hypothesis ("Profit… → Identify what evidence would… → Gather that specific evidence → …
  • The user faces a complex
  • SKILL.md covers Framework, Output Format, Examples and Gotchas, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Meta Structured Problem is an agent skill from asgard-ai-platform/skills. Apply structured problem-solving using MECE principle, issue trees, hypothesis-driven approach, and the Pyramid Principle. Use this skill when the user faces a complex, ambiguous problem and needs to decompose it systematically, structure a consulting-style analysis, or organize recommendations clearly — even if they say 'where do I start', 'this problem is too big', 'help me break this down', or 'structure my thinking'.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `examples/sample_scenario.md`, `references/issue-tree-templates.md` and `references/pyramid-principle.md`).

The repository describes itself as: 301 open-source coding agent skills across 22 domains — methodology, judgment & gotchas packaged as Claude Agent Skills for the Asgard AI Platform. The licence is MIT.

When your agent uses it

  • The user faces a complex
  • Ambiguous problem and needs to decompose it systematically
  • Structure a consulting-style analysis
  • Organize recommendations clearly — even if they say where do I start

Example prompts

  • “where do I start”
  • “this problem is too big”
  • “help me break this down”
  • “/meta-structured-problem”

Workflow steps

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

  1. Form an initial hypothesis ("Profit declined because churn increased")
  2. Identify what evidence would prove/disprove it
  3. Gather that specific evidence
  4. Refine or reject the hypothesis
  5. Repeat

What it can do on your machine

Read from SKILL.md and the folder at commit 4e7f4f8. 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 (its code samples are markdown).

    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

Meta Structured Problem loads about 1.4k tokens when it runs, and up to ~6.5k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 459 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.5k

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 asgard-ai-platform/skills at commit 4e7f4f8, republished under its MIT licence (© asgard-ai-platform). 459 words, ~1,390 tokens.

Download SKILL.mdSave it as .claude/skills/meta-structured-problem/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
meta-structured-problem
description
Apply structured problem-solving using MECE principle, issue trees, hypothesis-driven approach, and the Pyramid Principle. Use this skill when the user faces a complex, ambiguous problem and needs to decompose it systematically, structure a consulting-style analysis, or organize recommendations clearly — even if they say 'where do I start', 'this problem is too big', 'help me break this down', or 'structure my thinking'.
metadata.category
WP-22 跨學科
metadata.tags
meta-thinking, structured-problem-solving, mece, mckinsey

Structured Problem Solving

Framework

IRON LAW: MECE or It's Not Structured

Every decomposition must be MECE:
- Mutually Exclusive: No overlap between categories
- Collectively Exhaustive: No gaps — all possibilities covered

"Revenue = New customers + Existing customers" is MECE ✓
"Revenue = Online + Enterprise + Growth" is NOT MECE ✗ (overlapping)
Core Tools

Issue Tree: Decompose a question into sub-questions, MECE at each level

"Why is profit declining?"
├── Revenue declining?
│   ├── Volume down?
│   │   ├── New customer acquisition down?
│   │   └── Existing customer churn up?
│   └── Price down?
│       ├── Discounting increased?
│       └── Mix shift to lower-priced products?
└── Costs increasing?
    ├── COGS up?
    └── OpEx up?

Hypothesis-Driven Approach: Instead of exploring everything, state a hypothesis and test it

  1. Form an initial hypothesis ("Profit declined because churn increased")
  2. Identify what evidence would prove/disprove it
  3. Gather that specific evidence
  4. Refine or reject the hypothesis
  5. Repeat

Pyramid Principle (Barbara Minto): Structure communication top-down

  1. Lead with the answer: Start with the recommendation, not the analysis
  2. Group supporting arguments: 3-5 supporting points, MECE
  3. Order logically: By argument strength, chronologically, or structurally
  4. Detail only when asked: Each level provides more detail for those who want it

80/20 Rule: Focus on the 20% of analysis that drives 80% of the answer. Don't over-analyze secondary branches of the issue tree.

Problem Solving Process
  1. Define the problem: "The client's profit has declined 15% YoY. Why, and what should they do?"
  2. Structure with an issue tree: MECE decomposition of possible causes
  3. Prioritize branches: Which branches are most likely to contain the answer? (80/20)
  4. Form hypotheses: "I believe the primary cause is..."
  5. Gather evidence: Test each hypothesis with data
  6. Synthesize findings: What does the evidence say?
  7. Recommend: Present using the Pyramid Principle (answer first)

Output Format

markdown
# Structured Analysis: {Problem}

## Problem Statement
{One sentence, specific and measurable}

## Issue Tree
{MECE decomposition — text or visual}

## Hypothesis
{Initial hypothesis with rationale}

## Evidence
| Branch | Hypothesis | Evidence | Verdict |
|--------|-----------|---------|---------|
| {branch} | {sub-hypothesis} | {data found} | Confirmed/Rejected |

## Synthesis (Pyramid Structure)
**Recommendation**: {answer first}

**Supporting Arguments**:
1. {argument 1 with evidence}
2. {argument 2 with evidence}
3. {argument 3 with evidence}

## Next Steps
1. {action item}

Examples

Correct Application

Scenario: "Why is our food delivery app losing market share?"

Issue tree (MECE):

Market share declining
├── Our growth slowing?
│   ├── New user acquisition down?
│   │   ├── Marketing spend reduced?
│   │   └── Conversion rate dropped?
│   └── Existing user activity down?
│       ├── Order frequency declining?
│       └── Users churning?
└── Competitors growing faster?
    ├── New entrant capturing share?
    └── Existing competitor accelerating?

Hypothesis: "Existing user activity is down because order frequency declined after the delivery fee increase." Evidence: Order frequency dropped 22% in the month after fee increase. ✓

Pyramid: "Reverse the delivery fee increase for high-frequency users. Order frequency dropped 22% post-increase, and 60% of lost orders came from users who ordered 3+/week. A loyalty tier with waived fees for frequent users would recover an estimated 15% of lost share at a cost of NT$X/month."

Show full SKILL.md (158 more words)Show less
Incorrect Application
  • Issue tree: "Revenue problem: Online, Marketing, Customer Service" → Not MECE (overlapping categories, not exhaustive). Violates Iron Law.

Gotchas

  • MECE is hard in practice: Perfect MECE is aspirational. Get as close as possible and note where categories blur. "Good enough MECE" beats "perfect but took 3 days."
  • Hypothesis-driven ≠ confirmation bias: The hypothesis is a starting point to guide investigation, not a conclusion to defend. If evidence contradicts it, change the hypothesis.
  • The Pyramid Principle feels counterintuitive: People naturally want to tell the story chronologically (problem → analysis → conclusion). Audiences want the answer FIRST, then the supporting evidence. Lead with the recommendation.
  • Structured ≠ slow: Spending 30 minutes structuring the problem saves hours of unfocused analysis. The structure IS the speed.
  • Know when to stop: Analysis has diminishing returns. If you have enough evidence to make a confident recommendation, stop analyzing and recommend.

References

  • For issue tree templates by problem type, see references/issue-tree-templates.md
  • For Pyramid Principle writing guide, see references/pyramid-principle.md

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

Files

SKILL.md and 3 other files (references) in meta-structured-problem of asgard-ai-platform/skills.

  • SKILL.md
  • examples/sample_scenario.md
  • references/issue-tree-templates.md
  • references/pyramid-principle.md

Open the folder on GitHubat commit 4e7f4f8

Compare with similar skills

Meta Structured Problem 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.

Meta Structured Problem compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Meta Structured Problem this skillasgard-ai-platform/skills241—~1.4kAutomated safety check: PassMIT
Vc Problem Solvingwithkynam/vibecode-pro-max-kit1.1k2 repos~1.1kAutomated safety check: PassMIT
Principle Redesign From First Principlescursor/plugins10k8 repos~211Automated safety check: PassNone
Worked Example To Problem Solving Transition DesignerGarethManning/education-agent-skills835—~6.2kAutomated safety check: PassCustom licence
Is This A Problemanthropics/claude-for-legal9.6k2 repos~2.3kAutomated safety check: PassApache-2.0
More Trees AutomationComposioHQ/awesome-claude-skills77k3 repos~742Automated safety check: PassNone

Similar skills

  • Vc Problem Solving

    withkynam/vibecode-pro-max-kit

    Apply systematic problem-solving techniques when stuck. An agent skill from withkynam/vibecode-pro-max-kit.

    1.1k GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Worked Example To Problem Solving Transition Designer

    GarethManning/education-agent-skills

    Design the transition from worked examples to independent problem-solving using expertise-reversal principles.

    835 GitHub stars~6.2k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Is This A Problem

    anthropics/claude-for-legal

    Official

    Fast "is this a problem?" answer for the quick Slack question — pattern-matches against your calibration.

    9.6k GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • More Trees Automation

    ComposioHQ/awesome-claude-skills

    Automate More Trees tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~742 tokens
    Productivity & AutomationAuto-check passed
  • Resourceful Problem Solving

    swarmclawai/swarmclaw

    Always-on guidance for solving tasks resourcefully. An agent skill from swarmclawai/swarmclaw.

    688 GitHub stars~460 tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed

More from asgard-ai-platform/skills

All 209 skills in this repo
  • Algo Sc Eoq

    asgard-ai-platform/skills

    Calculate Economic Order Quantity to minimize total inventory cost (ordering + holding).

    241 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Algo Ecom Bm25

    asgard-ai-platform/skills

    Implement BM25 ranking function for e-commerce product search relevance scoring.

    241 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Mfg Cpk

    asgard-ai-platform/skills

    Calculate Cpk process capability index to assess whether a process meets specification requirements.

    241 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Price Elasticity

    asgard-ai-platform/skills

    Calculate price elasticity of demand to quantify how price changes affect sales volume.

    241 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Bayesian

    asgard-ai-platform/skills

    Apply Bayesian averaging to rank items by combining observed ratings with prior expectations.

    241 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Elo

    asgard-ai-platform/skills

    Implement Elo rating system to rank items or players from pairwise comparison outcomes.

    241 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Meta Structured Problem

What does Meta Structured Problem do?

Apply structured problem-solving using MECE principle, issue trees, hypothesis-driven approach, and the Pyramid Principle. Meta Structured Problem is an agent skill from asgard-ai-platform/skills. Apply structured problem-solving using MECE principle, issue trees, hypothesis-driven approach, and the Pyramid Principle.

When should I use Meta Structured Problem?

Meta Structured Problem fits situations like: the user faces a complex; ambiguous problem and needs to decompose it systematically; structure a consulting-style analysis; organize recommendations clearly — even if they say where do I start.

How do I install Meta Structured Problem in Claude Code?

Run `npx skills add asgard-ai-platform/skills --skill meta-structured-problem -a claude-code`. Or copy the skill folder (meta-structured-problem in asgard-ai-platform/skills) into .claude/skills/meta-structured-problem in your project. Claude Code loads it when a task matches its description.

How do I install Meta Structured Problem in Codex?

Run `npx skills add asgard-ai-platform/skills --skill meta-structured-problem -a codex`. Or copy the skill folder (meta-structured-problem in asgard-ai-platform/skills) into .agents/skills/meta-structured-problem in your project. Codex loads it when a task matches its description.

Can I use Meta Structured Problem 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 asgard-ai-platform/skills --skill meta-structured-problem -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/meta-structured-problem, .gemini/skills/meta-structured-problem, .github/skills/meta-structured-problem and .opencode/skills/meta-structured-problem in your project.

What does Meta Structured Problem need to run?

SKILL.md names no scripts, command-line tools or credentials: Meta Structured Problem is instructions for the agent only.

Does Meta Structured Problem 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 Meta Structured Problem 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 Meta Structured Problem use?

Meta Structured Problem 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 Meta Structured Problem use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.1k tokens, read only when the agent opens those files.

What are the alternatives to Meta Structured Problem?

Skills that share tags, products or a category with Meta Structured Problem: Vc Problem Solving (withkynam/vibecode-pro-max-kit, 1.1k stars), Principle Redesign From First Principles (cursor/plugins, 10k stars), Worked Example To Problem Solving Transition Designer (GarethManning/education-agent-skills, 835 stars) and Is This A Problem (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Meta Structured Problem?

asgard-ai-platform (a GitHub organization) maintains it in asgard-ai-platform/skills, which has 241 GitHub stars. The repository holds 209 skills in this directory. The repository was last updated on June 6, 2026.

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