thinking-bounded-rationality
This skill helps agents make timely decisions under resource constraints by setting a good-enough threshold upfront, then stopping at the first option that…
Community author
- Agents
- Claude Code
- License
- MIT (permissive)
- Pin
- 7b8fecepinned Oct 9, 2026
- Context cost
- about 650 tokenswhen the skill loads
- GitHub stars
- 1,612on tjboudreaux/cc-thinking-skills
- Scripts
- None found
What it does
“Use when search or investigation could run forever. Set an explicit good-enough threshold first, then stop at the first option that clears it.”
Generated summary from the skill's own text
This skill helps agents make timely decisions under resource constraints by setting a good-enough threshold upfront, then stopping at the first option that meets it. It prevents endless searching or comparison by requiring explicit criteria before evaluation and halting as soon as those criteria are satisfied. The skill includes guards against misuse on high-stakes, irreversible, or correctness-critical decisions where the best option genuinely matters.
When to use it
- Search or comparison has no natural stopping point and could exhaust budgets.
- Multiple adequate options exist and further ranking adds little value.
- The decision is reversible or low-stakes relative to investigation cost.
- You need to ship quickly and preserve budget for execution.
When not to
- Irreversible or high-stakes choices like data loss, security, or migrations where best matters.
- Correctness gates such as tests, security checks, or fix verification need the right answer.
- A single cheap lookup would settle the fact; look it up instead.
Install
These commands install from the publisher's repository and need no account.
skills CLI
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-bounded-rationalityInstalls from the repository's default branch, which may have changed since the commit we checked.
GitHub CLI 2.90 or later
gh skill install tjboudreaux/cc-thinking-skills thinking-bounded-rationality@7b8fece345dfaa11773be7152ccd194589cb5437Installs the commit we checked (7b8fece).
Copy by hand
Download the folder at 7b8fece and put it in .claude/skills/thinking-bounded-rationality for Claude Code and in .agents/skills/thinking-bounded-rationality for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.
Copy for your agent
A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.
Prompt
Install the agent skill "thinking-bounded-rationality" by tjboudreaux. Source, pinned to commit 7b8fece345dfaa11773be7152ccd194589cb5437: https://github.com/tjboudreaux/cc-thinking-skills/tree/7b8fece345dfaa11773be7152ccd194589cb5437/skills/thinking-bounded-rationality 1. Download that folder at exactly this commit. Do not use the default branch. 2. Copy every file unchanged, keeping the folder structure, into .claude/skills/thinking-bounded-rationality/ for Claude Code and .agents/skills/thinking-bounded-rationality/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist. 3. Do not edit the files, and do not run any script in the folder unless I ask you to. 4. When you are done, list the files you copied and where you put them. Listing and checks: https://www.agentnative.dev/skills/tjboudreaux/thinking-bounded-rationality
SKILL.md at the pin
--- name: thinking-bounded-rationality description: Use when search or investigation could run forever. Set an explicit good-enough threshold first, then stop at the first option that clears it. disable-model-invocation: true --- # Bounded Rationality Under finite tool, context, and time budgets, stop at the first option that meets a predeclared aspiration level. Optimize only when the good-to-best gap is worth the remaining budget. ## When to Use - Search or option comparison has no natural endpoint and could consume the turn budget. - Multiple options would clear the requirement and further comparison has diminishing returns. - The decision is reversible or low-stakes relative to more search. - You are gathering context beyond what the decision needs to ship. ## When NOT to Use - Irreversible or high-stakes choices (data loss, security, migrations, public commitments) where the good-to-best gap is material. - Correctness gates: tests, security checks, and "did the fix work?" need the right answer, not a sufficient-looking one. - One cheap lookup would settle the fact — do it; do not satisfice past it. - The aspiration level cannot be stated — clarify the requirement first. ## Procedure 1. **State decision and budget.** Name the choice, residual tool/context/time budget, and reversibility. 2. **Set aspiration before searching.** Write concrete pass/fail criteria for "good enough." Do not evaluate until the threshold is explicit. 3. **Search sequentially.** Score options in encounter order against the threshold only. Skip full matrices unless step 1 marked high-stakes/irreversible. 4. **Stop at first adequate.** When an option clears every criterion, select it immediately. 5. **Handle search failure without moving the goalposts.** If nothing clears after the pre-set cap, preserve the threshold and report no adequate option. Relax only a criterion predeclared as non-load-bearing, record the relaxation, and resume within a new cap; never raise the bar after failure. 6. **Commit.** Record choice and residual uncertainty; spend remaining budget on execution, not re-ranking. **Stop condition:** First option meets the predeclared aspiration level, or the search cap is exhausted with none adequate. ## Output ```text Decision: <choice> Aspiration: <pass/fail criteria> Search: evaluated N; stopped at first adequate | cap exhausted Selected: <option or none> Residual risk: <what further search might change> Next spend: <execution step> ``` ## Verification - Falsify if you kept comparing after an option cleared the threshold, or invented the threshold after seeing winners. - Falsify if a correctness gate or irreversible decision was treated as satisficeable. - Over-application guard: if one cheap check settles a fact, look it up — do not invoke this skill.
From tjboudreaux/cc-thinking-skills at 7b8fece, shown as plain text under its license: MIT (permissive). The license text is in LICENSE.
View SKILL.md on GitHub at 7b8feceFiles
- SKILL.md2.8 KB · 1996c6a4218a
1 file, 2.8 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.
Skill folder on GitHub at 7b8feceRelated in Productivity
suggest-automations
This skill suggests three relevant automations to users based on their team role and connected apps, then builds the chosen workflow using the build-workflow…
by n8nOfficial publisher
Claude Code, Codex, Cursor +3 · about 1.9K tokens · pinned 6 days ago
agent-mail-automation
This skill enables agents to automate email operations through Composio's Agent Mail toolkit via the Rube MCP server.
by ComposioOfficial publisher
Claude Code, Codex, Cursor +3 · about 700 tokens · pinned 6 days ago
inbox-manager
This skill transforms an overflowing inbox into a short prioritized list by reading email from Gmail, Microsoft 365, or pasted text, sorting messages into…
by AnthropicOfficial publisher
Claude Code, Codex, Cursor +4 · about 2.5K tokens · pinned 6 days ago
huggingface-papers
This skill retrieves and analyzes AI research papers from Hugging Face's paper index and arXiv by fetching paper content as markdown or structured metadata…
by Hugging FaceOfficial publisher
Claude Code, Codex, Cursor +4 · about 2.2K tokens · pinned 6 days ago
curating-memory-palace
This skill lets the agent maintain a Memory Palace, a structured dashboard view that shows the user what the agent is working on, what it could do next, and…
by LettaOfficial publisher
Agents not labelled yet · about 3.1K tokens · pinned 6 days ago
scheduling-tasks
This skill lets you create and manage scheduled tasks using the letta cron CLI, sending prompts to the agent on a timer for reminders, periodic work, and…
by LettaOfficial publisher
Claude Code, Codex, Cursor +4 · about 2.3K tokens · pinned 6 days ago