complex-problem-solving
Skill1 starsChanged 3 months agoMITView on GitHub
Structure and solve difficult, ambiguous, or high-consequence problems that require decomposition, competing hypotheses, tradeoff analysis, and verification. Use when the answer is not a straightforward lookup or routine implementation.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- joobid/CPS-skillstheir own version, first seen Oct 25, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- joobid/CPS-skills★ 14same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository25 other files it gives its agents.
- automateSkill
- autopilotSkill
- canvasSkill
- cost-estimateSkill
- create-hookSkill
- create-ruleSkill
- create-skillSkill
- create-subagentSkill
- deep-researchSkill
- large-figma-featureSkill
- loopSkill
- migrate-to-skillsSkill
- onboardSkill
- rename-chatSkill
- review-bugbotSkill
- review-securitySkill
- reviewSkill
- sdkSkill
- shellSkill
- split-to-prsSkill
- statuslineSkill
- update-cli-configSkill
- update-cursor-settingsSkill
- xcost-estimateSkill
- youspeak-aws-powerSkill
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 20
Test the strongest alternatives against evidence, constraints, failure modes, reversibility, cost, and second-order effects.
- Distinctive: line 21
Look for disconfirming evidence and boundary cases.
- Distinctive: line 22
Prefer the simplest option that satisfies the success criteria, but retain necessary complexity when simplification would hide risk.
- Distinctive: line 27
Use tools, experiments, calculations, logs, or primary sources when they can resolve uncertainty.
- Distinctive: line 29
If evidence overturns the initial framing, update the model of the problem rather than defending the first approach.
≈ “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
Complex Problem Solving
Turn an unclear or difficult problem into a defensible solution while preserving the user's objective and constraints.
Frame the problem
- Restate the desired outcome, success criteria, constraints, and relevant unknowns.
- Separate facts, assumptions, interpretations, and preferences. Verify consequential assumptions where possible.
- Identify the smallest missing information that would materially change the solution. Ask only when it cannot be discovered safely and guessing would be risky.
Build the solution
- Decompose the problem into independently testable parts and expose important dependencies.
- Generate genuinely different candidate explanations or approaches before committing. Include the status quo when it is a meaningful option.
- Test the strongest alternatives against evidence, constraints, failure modes, reversibility, cost, and second-order effects.
- Look for disconfirming evidence and boundary cases. Do not confuse a plausible narrative with a demonstrated cause.
- Prefer the simplest option that satisfies the success criteria, but retain necessary complexity when simplification would hide risk.
Execute and verify
- For implementation tasks, convert the chosen approach into observable checkpoints and test the highest-risk assumptions early.
- Use tools, experiments, calculations, logs, or primary sources when they can resolve uncertainty. Do not fabricate results.
- Preserve user authorization boundaries; analysis does not imply permission for unrelated or irreversible actions.
- If evidence overturns the initial framing, update the model of the problem rather than defending the first approach.
Communicate the result
Lead with the recommendation or result. Explain the decisive evidence, material assumptions, rejected alternatives, remaining uncertainty, and the next action. Match depth to the stakes; do not expose private chain-of-thought or pad the response with generic process narration.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
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.

