agentleFS
rongarederongarede/claude-skills-research/skills/deep-think/SKILL.md

deep-think

Skill3 starsChanged 8 months agoMITView on GitHub

Extended reasoning and deliberation for complex, ambiguous, or high-stakes problems. Use when standard analysis is insufficient — multi-dimensional trade-offs, philosophical questions, architectural decisions with long-term consequences, or problems where the first obvious answer is likely wrong. Forces slower, more thorough thinking with explicit reasoning chains.

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use ecosystem-reference, fractal-delegation and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • naman10parikhSkill

    ecosystem-reference

    Quick-access directory of Claude Code ecosystem repos, skills, plugins, MCPs, and patterns. Use when improving the harness.

    Also in 5 projects that use this

  • naman10parikhSkill

    fractal-delegation

    Also in 5 projects that use this

  • KirchliveSkill

    skill-routing

    Decides which of the installed skills a task needs and loads them before the work starts. This skill should be used at the beginning of any multi-step task — build, fix, refactor, migrate, review, plan, release, research, write, design, video — and again at every phase change, after context compaction, and when work moves into a different part of the codebase. Use it for requests like "let's build X", "fix this bug", "refactor Y", "plan the migration", "review this", and also when the user asks which skill applies, why a skill did not fire, or asks to check what is available.

    Also in 5 projects that use this

  • sublimotionSkill

    agent-runtime

    Launch and manage detached agent runs on EKS via the agent-runner CLI. Use when the user says "launch an agent run", "agent runtime", "agent-runner", "run this spec on the cluster", "check run status", "agent run logs", or "stop a run". Do NOT use for writing the agent-runner code itself (edit the sibling ../agent-runner repo), Terraform of the foundation (use terraform-automation), or GPU serving deployments (use infra-deployer).

    Also in 5 projects that use this

  • GoZippySkill

    repo-scout

    Also in 5 projects that use this

  • BenjaminGSkill

    harness-review

    Turn one PR's review comments into harness fixes — classify each cause by the most solid place it can live (codebase, lint, rules, skill), then draft the fixes in a separate PR.

    Also in 5 projects that use this

  • +6 more from naman10parikh

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 13 edited versions we read keep these.

  • 7

    Distinctive

    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:

    Use these when stuck:

    line 159
  2. Distinctive:

    Do NOT rush to a conclusion — the point is thorough deliberation

    line 182
  3. Distinctive:

    Do NOT ignore uncomfortable evidence

    line 183
  4. Distinctive:

    Do NOT confuse complexity with depth

    line 184
  5. Distinctive:

    Do NOT present analysis without stating confidence levels

    line 185
  6. Distinctive:

    Do NOT skip the assumption-surfacing step

    line 186
  7. Distinctive:

    Do NOT use this for simple questions that have clear answers

    line 187

“Common” is measured: kept by at least 6 in 10 of the 13 edited versions of this file we could read. “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

Deep Think

Extended deliberation skill for problems that resist quick answers. Forces multi-step reasoning, considers second-order effects, and produces well-justified conclusions.

Trigger Words

  • /deep-think
  • "think deeply about"
  • "reason through this"
  • "what are the second-order effects"
  • "this is a hard problem"
  • "deliberate on"
  • "think step by step"

When to Use

  • Architectural decisions with 6+ month consequences
  • Trade-offs where multiple options seem equally valid
  • Problems where the obvious answer might be wrong
  • Multi-stakeholder decisions with conflicting interests
  • Ethical or philosophical dimensions
  • Debugging subtle, hard-to-reproduce issues
  • Strategy formulation under uncertainty

Core Process

Deep Think Progress:
- [ ] Step 1: Problem decomposition
- [ ] Step 2: Assumption surfacing
- [ ] Step 3: Multi-perspective analysis
- [ ] Step 4: Second-order effects mapping
- [ ] Step 5: Synthesis and conclusion
- [ ] Step 6: Confidence calibration

Step 1: Problem Decomposition

Break the problem into its constituent parts:

## Problem Statement
[Restate the problem in your own words]

## Sub-Problems
1. [Component A] — [why it matters]
2. [Component B] — [why it matters]
3. [Component C] — [why it matters]

## Dependencies
- [A] depends on [B] because...
- [C] is independent of [A/B]

Step 2: Assumption Surfacing

Explicitly list every assumption:

## Assumptions (must be stated explicitly)

| # | Assumption | Type | If Wrong, Impact |
|---|-----------|------|------------------|
| 1 | [assumption] | [factual/value/scope] | [consequence] |
| 2 | [assumption] | [factual/value/scope] | [consequence] |

Challenge each assumption:

  • Is this actually true, or do we just believe it?
  • What evidence supports/contradicts this?
  • What if the opposite were true?

Step 3: Multi-Perspective Analysis

Analyze from at least 3 different viewpoints:

## Perspectives

### Perspective 1: [Role/Viewpoint]
- Sees the problem as: [framing]
- Prioritizes: [values]
- Would decide: [choice]
- Reasoning: [chain]

### Perspective 2: [Role/Viewpoint]
[same structure]

### Perspective 3: Devil's Advocate
- The strongest argument against the emerging consensus is: [argument]
- Evidence supporting this counter-view: [evidence]
- This matters because: [reason]

Step 4: Second-Order Effects

## Effects Cascade

### First-Order (Direct)
- If we choose X: [immediate consequence]

### Second-Order (Indirect)
- That consequence leads to: [downstream effect]
- Which in turn causes: [further downstream]

### Third-Order (Systemic)
- Over time, the system adapts by: [emergent behavior]

### Reversibility Assessment
- Can we undo this decision? [yes/partially/no]
- Cost of reversal: [low/medium/high/impossible]
- Time window for reversal: [timeframe]

Step 5: Synthesis

## Synthesis

### What the evidence tells us
[Integrate findings from all perspectives]

### What remains uncertain
[Honest assessment of unknowns]

### Recommended path
[Clear recommendation with reasoning chain]

### Key insight
[The single most important thing learned through this analysis]

Step 6: Confidence Calibration

## Confidence Assessment

| Aspect | Confidence | Basis |
|--------|-----------|-------|
| Problem understanding | [0-100%] | [why] |
| Solution correctness | [0-100%] | [why] |
| Implementation feasibility | [0-100%] | [why] |
| Overall recommendation | [0-100%] | [why] |

### What would change my mind
- If [condition], I would reconsider [aspect]
- New information about [topic] could shift the analysis

Thinking Techniques

Use these when stuck:

TechniqueWhen to UseHow
Inversion"What would make this fail?"Think about the opposite
First PrinciplesAssumptions feel shakyStrip to fundamental truths
Pre-mortemBefore committing"It's 6 months later and this failed — why?"
Steel ManConsidering alternativesMake the strongest case for the opposing view
Regret MinimizationLong-term decisions"Which choice minimizes regret in 10 years?"
Fermi EstimationQuantifying unknownsOrder-of-magnitude estimates with reasoning

Output Format

Always produce:

  1. Problem restatement (in your own words)
  2. Key assumptions (explicit, numbered)
  3. Analysis (multi-perspective, with reasoning chains)
  4. Second-order effects (at least 2 levels deep)
  5. Conclusion (with confidence level and what would change your mind)

Anti-Patterns

  • Do NOT rush to a conclusion — the point is thorough deliberation
  • Do NOT ignore uncomfortable evidence
  • Do NOT confuse complexity with depth
  • Do NOT present analysis without stating confidence levels
  • Do NOT skip the assumption-surfacing step
  • Do NOT use this for simple questions that have clear answers

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.

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.