Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-second-order -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/thinking-second-order/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/thinking-second-order/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set28

thinking-systems A skill for problems that resist local fixes: it maps the system, finds feedback loops and delays, then ranks interventions by leverage. CX Codex +1 610installs thinking-opportunity-cost Forces your AI coding agent to identify the best forgone alternative and calculate the net value delta before committing engineering hours or budget. CX Codex +1 610installs thinking-model-router A router skill that maps domain and problem type to one thinking skill, or returns NONE. Useful when you would otherwise guess or stack frameworks. CX Codex +1 605installs thinking-steel-manning Builds the strongest opposing argument before rejecting or adopting a technical plan. Useful for architecture reviews and preventing sycophantic AI agreement. CX Codex +1 600installs thinking-triz A skill for when two design requirements pull against each other. It names the conflict and looks for a resolution that keeps both benefits. CX Codex +1 593installs thinking-probabilistic A skill that makes the agent name a base rate, give confidence intervals and update its estimate when new evidence lands, instead of stating one confident number. CX Codex +1 591installs thinking-scientific-method Structured debugging skill that ranks falsifiable hypotheses and runs the cheapest discriminating check before changing code. CX Codex +1 587installs thinking-reversibility A skill that makes the agent check how expensive a decision is to undo before it decides how much analysis to spend. Useful when you can't tell whether deep thought is warranted. CX Codex +1 577installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor