thinking-second-order — Claude Code skill: install guide
Traces consequences beyond an immediate fix, including reactions, timing, probability and feedback. Use it for architecture or strategic decisions with lasting effects.
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a claude-codeWhat thinking-second-order does
thinking-second-order examines a decision beyond its intended first effect. It records the action and immediate outcome, then follows later consequences by repeatedly asking what happens next.
For each link, the skill captures affected actors, a rough probability, timing, and feedback into the original problem. It also tests what changes at 10x usage, then retains risks only when they alter the go/no-go decision, design, or mitigations.
The model does not invoke this skill on its own, so ask for it explicitly. For a local reversible edit without behavioural or cross-component effects, this process is unnecessary; the guidance says to ship the change and observe it instead.
What it helps with
- trace delayed consequences of an architecture decision
- assess stakeholder reactions to changed incentives
- test a decision under 10x usage
- discard speculative risk chains without a mechanism
- define mitigations for kept second-order risks
Example prompts for the agent
- Use thinking-second-order to assess adding a new API limit.
- Apply thinking-second-order to this architecture choice and list second- and third-order effects.
- Run thinking-second-order on this decision, including probability and timing for each consequence.
How to install thinking-second-order
1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a claude-code2Manually: put the files in place
~/.claude/skills/thinking-second-order/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/thinking-second-order/
1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a codex2Manually: put the files in place
.agents/skills/thinking-second-order/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a cursor2Manually: put the files in place
.cursor/skills/thinking-second-order/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tjboudreaux/cc-thinking-skills thinking-second-order2Manually: put the files in place
.github/skills/thinking-second-order/SKILL.md1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a gemini-cli2Platform CLI
gemini skills install https://github.com/tjboudreaux/cc-thinking-skills --path skills/thinking-second-orderManually: put the files in place
.devin/skills/thinking-second-order/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about thinking-second-order
How do I install thinking-second-order in Claude Code?
Run npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a claude-code, then run npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a claude-code again. The skill file is at ~/.claude/skills/thinking-second-order/SKILL.md.
What does thinking-second-order do?
It traces a decision’s consequence chain beyond the first intended effect. The analysis covers actors, probability, timing, feedback, and effects that emerge as usage grows.
When should I avoid using thinking-second-order?
Avoid it for mechanical edits such as renaming or formatting, and for local reversible changes with no behavioural effects. For system structure with many loops, the guidance directs you to systems instead.
Source text
SKILL.md · MIT
---
name: thinking-second-order
description: When a change has effects past the immediate fix—incentives, scale, feedback—trace consequence chains with timing and probability before committing.
disable-model-invocation: true
---
# Second-Order Consequence Chains
Do not stop at the intended first effect. Trace what happens next across actors, time, and feedback until the chain stops changing the decision.
## When to Use
- Strategic, policy, incentive, or architecture choices with lasting coupling.
- The obvious fix feels too easy or has known backfire patterns.
- Success or scale would create new problems (load, gaming, debt).
- Need to compare options by delayed effects, not only day-one benefit.
## When NOT to Use
- Local reversible edit with no incentive or cross-component coupling—just ship and observe.
- Full system structure (stocks, many loops, leverage ranking) is the goal—use systems.
- Pre-mortem of failure modes for a plan already chosen—use pre-mortem.
- Pure mechanical changes (rename, format) with no behavioral effect.
## Procedure
1. **State decision and first-order effect.** One sentence each: action and intended immediate result.
2. **Chain "and then what?"** At least two further orders. For each link record: effect, who responds, rough probability (high/med/low), timing (immediate / next cycle / at scale), and whether it feeds back into the original problem (reinforce or counteract).
3. **Expand affected parties.** Who else reacts (users, operators, other teams, attackers, markets)? What incentives does the change create or destroy?
4. **Scale test.** Ask what happens if everyone does this or usage grows 10x. Mark paths that only appear under scale or repetition.
5. **Prune and decide.** Drop speculative links that do not change the choice. Keep only effects that alter go/no-go, design, or mitigations. Revise the action or add guards where second-order harm exceeds first-order gain.
**Stop when** further "and then what?" no longer changes the decision, or the remaining chain is pure speculation without mechanism.
## Output
```text
decision: <action>
first_order: <intended immediate effect>
chain:
- order: 2
effect: <what>
actors: <who>
p: high|med|low
when: immediate|next_cycle|at_scale
feedback: none|reinforce|balance
- order: 3
...
scale_if_universal: <one sentence or n/a>
revised_decision: <same | modified action | no-go>
mitigations: <guards for kept risks>
```
## Verification
- **Falsify:** If no credible second-order path changes the choice, first-order is enough—stop inventing cascades. If the core issue is multi-loop structure rather than one decision's trail, switch to systems.
- **Stop:** End at the first order that no longer affects the decision; do not pad to a fixed depth.
- **Over-application guard:** No low-probability sci-fi chains. No treating parameter tweaks as deep strategy. Probability and timing required on kept links; omit decoration without mechanism.
© tjboudreaux · MIT · tjboudreaux/cc-thinking-skills