problem-solving-process
Skill0 starsChanged 25 days agoMITView on GitHub
Structure business problem-solving through definition, decomposition, prioritization, investigation planning, analysis, and synthesis. Use for problem-solving process requests or turning an ambiguous business problem into an investigation plan.
In this repository22 other files it gives its agents.
- ai-writing-tellsSkill
- animated-explainerSkill
- ann-handleySkill
- buyer-personasSkill
- desktop-mockupSkill
- linkedin-guest-kitSkill
- mobile-mockupSkill
- pesty-asana-tasksSkill
- pesty-designSkill
- pesty-explainerSkill
- pesty-frontendSkill
- presentation-structureSkill
- pyramid-principleSkill
- scrSkill
- storybrandSkill
- storytellingSkill
- transcript-cleanupSkill
- ui-designSkill
- untangleSkill
- website-launch-impact-reportSkill
- youtube-thumbnailsSkill
- yt-structureSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Use define → dissect → prioritize → plan → analyze → synthesize to help the user reach an evidence-backed decision.
- Distinctive: line 18
Ask focused questions only when missing information materially affects framing.
- Distinctive: line 30
Treat the source's 80/20 language as a prioritization heuristic, not a numerical promise.
- Distinctive: line 42
When requested, carry out the relevant investigation within the user's authorized scope.
- Distinctive: line 48
Use Pyramid Principle when the recommendation needs stronger organization.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Problem Solving Process
Use define → dissect → prioritize → plan → analyze → synthesize to help the user reach an evidence-backed decision. This is adapted from Alexander Lyon's six-stage explanation, which he describes as one version rather than a definitive McKinsey standard.
Default to framing the problem and producing an investigation plan first. Use supplied information and inspect directly relevant supplied sources to ground that plan; do not launch broad independent research during this phase. An explicit request to investigate, analyze, recommend, or continue an existing plan permits the relevant later stages within the requested scope. Do not restart completed stages when adequate prior work is available.
Frame and plan
Define
Identify the desired outcome, observed gap, affected stakeholders, constraints, timeframe, and decision the work should support. Distinguish symptoms, possible causes, and proposed solutions. A preferred solution is something to examine, not proof of the problem or its cause.
Ask focused questions only when missing information materially affects framing. Produce a concise, solution-oriented problem statement, without embedding an unproven diagnosis or predetermined intervention. Label it provisional when essential facts or agreement remain unresolved; do not imply team consensus.
Dissect
Break the problem into useful component questions or testable hypotheses. Keep causes, possible interventions, and investigation tasks distinguishable. Attach available supporting evidence, uncertainty, and plausible alternative explanations. Use a simple text tree when it clarifies the problem.
Consult untangle when deeper decomposition is needed. Apply its relevant guidance within this workflow without requiring every tree mode or returning duplicate deliverables.
Prioritize
Rank questions and controllable actions by their likely importance to the outcome, considering potential impact, influence, uncertainty, and investigation effort. Explain the ranking qualitatively unless defensible estimates exist. A high-priority investigation is not yet a proven high-impact solution.
Treat the source's 80/20 language as a prioritization heuristic, not a numerical promise. Retain consequential external constraints even when the team cannot control them; focus action on what the team can influence without pretending uncontrollable factors are irrelevant.
Develop the investigation plan
For each priority, specify the question or hypothesis; evidence needed and its source or how to locate it; the proposed analysis or test; the expected output and how it informs the decision; and known ownership and dependencies. Label suggested roles and unassigned work explicitly. Do not invent deadlines or assignments.
Give the investigation an actionable starting point while allowing findings to change the framing, priorities, and next questions. Avoid detailed downstream tasks that depend on unresolved findings.
Default deliverable: A concise problem brief, decomposition, ranked priorities, and investigation work plan, ending with material open questions and the next evidence-gathering step. Use a table for the work plan when it improves readability. Recommendations about the underlying solution remain provisional until supported. Finish this phase when the user can see what to investigate, why it matters, and how the result will inform a decision; do not silently proceed into execution.
Continue into analysis and synthesis
When requested, carry out the relevant investigation within the user's authorized scope. If evidence or access is unavailable, report the specific gap and what can still be concluded; do not label a planned analysis as completed work.
Analyze: Assess quantitative or qualitative evidence, alternative explanations, limitations, and implications. Separate observations from causal claims and assumptions. Revisit the problem definition or priorities when findings warrant it; do not select a cause simply because other hypotheses remain unproven.
Synthesize: Recommend an action supported by the analysis, explaining its rationale, tradeoffs, confidence, unresolved uncertainty, and what would change the recommendation. The strength of the recommendation must reflect the strength of the evidence. Preserve contradictory findings rather than telling a one-sided story. If evidence cannot support a solution yet, recommend the next discriminating test instead of inventing certainty.
Use Pyramid Principle when the recommendation needs stronger organization. Use Presentation Structure when presentation preparation is requested. Do not automatically create a deck, assign tasks, contact stakeholders, or execute recommended business changes.
Review existing work
Review supplied problem statements, investigation plans, analyses, or recommendations at their current stage. Identify consequential weaknesses in framing, evidence, prioritization, feasibility, or inference. Revise when requested, distinguishing changes in substance from wording improvements. Honor critique-only requests without rewriting or executing the plan.
Source
Related skills are optional. If a linked sibling skill is not installed, use the guidance in this file rather than treating it as a missing prerequisite.
Read Alexander Lyon's problem-solving source notes for the original examples, stage explanations, or attribution questions. Routine work does not require loading it. Preserve the six-stage version taught in the video even though the linked McKinsey source is titled as a seven-step process. The notes summarize the source teaching; this skill's scope, defaults, and operational safeguards are adaptations.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

