Skills for Real Engineers. Straight from my .agents directory.
thinking-thought-experiment
Agent skill fromtjboudreaux/cc-thinking-skills
When a real test is too rare, large, or irreversible, run a controlled counterfactual: isolate one variable, fix conditions, trace the mechanistic chain, and bound what the result implies.
How to install thinking-thought-experiment
npx skills add tjboudreaux/cc-thinking-skills# or add only this skill to Claude Code: copy the folder
skills/thinking-thought-experiment/
# into
~/.claude/skills/thinking-thought-experiment/ (all projects)
.claude/skills/thinking-thought-experiment/ (one project)
1# Thought Experiment23When empiricism is out of reach, run a disciplined counterfactual: one isolated change, fixed conditions, step-by-step mechanism, and a hard bound on implications.45## When to Use67- You need behavior under failure, scale, or policy you cannot cheaply trigger or measure (region outage, 100x load, one-way architecture).8- A decision is expensive or irreversible and a mental trace can surface break points before commit.9- Edge cases are too costly to stage, but a mechanistic chain can still expose missing controls.1011## When NOT to Use1213- A cheap real test exists (load test, flag, query, spike) → run the test; do not substitute imagination.14- Adversarial security attack-path work → use red-team structure, not free-form scenarios.15- You already know the mechanism and only need a decision under known facts → decide; do not dramatize.16- Vague "what if everything" brainstorming without a single isolated variable → tighten or stop.1718## Procedure19201. **State the question and isolation.** Name exactly one primary variable or counterfactual change. Freeze all other conditions as the control world. Reject multi-variable "and also" scenarios.212. **Fix initial conditions.** Specify system state, load, configuration, actors, and what is *not* changed. Write values concrete enough that another agent could replay the setup.22…
Excerpt shown under the repository's MIT license.
More skills in cc-thinking-skills
Similar skill repositories
An agentic skills framework & software development methodology that works.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Production-grade engineering skills for AI coding agents.
The open-source app everyone uses to manage agents at work
