Agent Native

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…

by tjboudreauxCommunityNot reviewed

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.”
The author's description, from SKILL.md

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-rationality

Installs 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@7b8fece345dfaa11773be7152ccd194589cb5437

Installs 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.

Skill folder on GitHub at 7b8fece

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 7b8fece

Files

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 7b8fece
All Productivity skills
  • 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

The skills listed here are third-party software, collected from public GitHub repositories as a catalog of recent skills and provided as is. Agent Native does not write or control them and is not responsible for any harm, loss or damage caused by installing or using them. Labels and checks describe what we saw at one commit and are not a guarantee. Read a skill's files before you run it. Terms of use