agentleFS
GoodnessmbakaraGoodnessmbakara/codex-skills/skills/complex-problem-solving/SKILL.md

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

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
  1. Distinctive:

    Test the strongest alternatives against evidence, constraints, failure modes, reversibility, cost, and second-order effects.

    line 20
  2. Distinctive:

    Look for disconfirming evidence and boundary cases.

    line 21
  3. Distinctive:

    Prefer the simplest option that satisfies the success criteria, but retain necessary complexity when simplification would hide risk.

    line 22
  4. Distinctive:

    Use tools, experiments, calculations, logs, or primary sources when they can resolve uncertainty.

    line 27
  5. Distinctive:

    If evidence overturns the initial framing, update the model of the problem rather than defending the first approach.

    line 29

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.

Download now (ZIP)

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.