decide
Skill109 starsChanged 37 days agoMITView on GitHub
Structure a decision, not just advise on it. Switches modes when the question is "what should we do" - expands the real option set (status quo, defer, pilot, hybrids), classifies the decision type (reversibility, one-shot vs repeated, ruin exposure, risk vs radical uncertainty), applies the MATCHING decision rule (ergodic filter, expected-value decomposition, robustness / minimax regret, value-of-information), and delivers a recommendation with tripwires. KB-grounded in the user's own decision-science frameworks; runs the full reasoning-checks battery. Use when options or stakes are on the table ("X or Y?", "is it worth", go/no-go) - not for open exploration (/advise, /think-about-it) and never to relitigate a decision canon has already made (/canon-advise).
51 other projects use a version of this.
Adopted by
Most recently taken up by
- aditya-vermax/skillstheir own version, first seen Nov 8, 2026
- vimkim/my-skillstheir own version, first seen Nov 8, 2026
- yuri-xyz/skillstheir own version, first seen Nov 8, 2026
- blamechris/chroxytheir own version, first seen Nov 8, 2026
- dirien/yet-another-agent-harnesstheir own version, first seen Nov 8, 2026
- Integralist/agent-skillstheir own version, first seen Nov 6, 2026
Used with
Projects with it also use redesign, weekly and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
arjunkshahSkillredesign
Redesign existing interfaces to premium quality while preserving product goals and functional behavior.
Also in 3 projects that use this
gaiaaiagentSkillweekly
Generate a weekly digest rolling up dailies into higher-level pattern analysis
Also in 3 projects that use this
SethGammonSkillexperiment
Automated optimization loop with scalar fitness function. Proposes changes in isolated worktrees, measures with a metric command, keeps improvements, discards failures. Supports convergence detection and diminishing returns.
Also in 3 projects that use this
kv0906Skillinbox
Quick capture mode (with content) or batch processing mode (no content). GTD-style routing of inbox items to proper folders. Use "/inbox thought to capture" or "/inbox" to process.
Also in 3 projects that use this
AnthropicSkillbrief
Generate contextual briefings for legal work — daily summary, topic research, or incident response. Use when starting your day and need a scan of legal-relevant items across email, calendar, and contracts, when researching a specific legal question across internal sources, or when a developing situation (data breach, litigation threat, regulatory inquiry) needs rapid context.
Also in 5 projects that use this
genomewalkerSkillhealth
Soul system health check with remediation
Also in 3 projects that use this
Other versions51 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 51
- ParadevAI/Paradev★ 16ksame name
- superset-sh/superset★ 16ksame name
- coreyhaines31/makerskills★ 893same name
- me2resh/apexyard★ 542same name
- menkesu/awesome-pm-skills★ 441same name
- BlockRunAI/blockrun-mcp★ 389same name
- kv0906/pm-kit★ 138same name
- me2resh/agent-decision-record★ 48same name
- seandavi/lifeos-template★ 46same name
- alirezarezvani/gaios★ 37same name
41 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository61 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- adviseSkill
- ai-crystallizeSkill
- analyze-kbSkill
- auto-discoverySkill
- benchmark-memorySkill
- brain-mergeSkill
- changelog-protocolSkill
- coherence-sweepSkill
- compute-lifecycleSkill
- create-articleSkill
- create-explanatory-imageSkill
- deep-researchSkill
- detect-tensionsSkill
- dialecticSkill
- domain-watchSkill
- elicitation-techniquesSkill
- epistemic-classificationSkill
- epub-chapter-extractorSkill
- extract-document-insightsSkill
- extract-insightsSkill
- find-connectionsSkill
- first-runSkill
- get-perspective-onSkill
- get-youtube-transcriptSkill
- git-commit-pushSkill
- graduate-insightsSkill
- incubation-loopSkill
- ingest-sourceSkill
- insight-capture-formatSkill
- insight-interviewSkill
- integrate-recent-notesSkill
- learn-new-thingsSkill
- manage-reference-dataSkill
- manage-thinking-topicsSkill
- manage-watching-domainsSkill
- multi-format-book-extractorSkill
- nano-banana-image-generatorSkill
- propagate-changeSkill
- quick-searchSkill
- reasoning-checksSkill
- recallSkill
- ref-auditSkill
- ref-bridgeSkill
- ref-ingestSkill
- ref-querySkill
- ref-reconcileSkill
- ref-refreshSkill
- refresh-indexSkill
- ref-supersedeSkill
- scheduled-runSkill
- scope-mountSkill
- search-vaultSkill
- self-diagnosticSkill
- start-hereSkill
- synthesize-insightsSkill
- talkSkill
- test-memory-systemSkill
- think-about-itSkill
- update-changelogSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 3 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 50 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 40
Never writes. A decision brief may be saved to Brain/05-Meta/Reports/ only on explicit request (Step 8).
- Distinctive: line 79
Defer: - wait for information; a real option with a price (cost of delay) and a payoff (uncertainty resolved)
- Distinctive: line 103
Value of information: - if defer/pilot resolves a driving uncertainty and the delay cost is tolerable, the real option can beat both stated …
- Distinctive: line 146
If the KB lacks relevant frameworks, say so and structure the decision from general principles, labelled as such
“Common” is measured: kept by at least 6 in 10 of the 50 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Decide
ℹ️ First, set expectations: print one line with this skill's version and its most recent change - the top of
metadata.changelog- e.g.decide v1.0 — recent: initial decision-structuring skill. Then proceed.
Purpose
/advise produces a better map; /decide produces a choice. When the question is "what should we do", frameworks alone under-deliver - the output must be a recommendation produced by an explicit decision rule, with the losing options accounted for and tripwires attached. The KB skeleton is decision science (Kahneman / Gilbert / Tetlock / Thaler / Kay-King, bound by Ergodicity); this skill is where that skeleton actually decides instead of only describing.
Problem
$ARGUMENTS
State Dependencies
| Source | Location | Read | Write |
| LBS search | resources/local-brain-search/run_search.sh | ✓ | |
| Core hubs (attractor check) | resources/local-brain-search/run_connections.sh --hubs --json | ✓ | |
| KB notes | Brain/**/*.md | ✓ | |
| Reasoning-checks contract | .claude/skills/reasoning-checks/SKILL.md | ✓ | |
| Canon (conditional) | Brain/Canon/**/*.md via canon-mounted search | ✓ |
Never writes. A decision brief may be saved to Brain/05-Meta/Reports/ only on explicit request (Step 8).
Composes
reasoning-checks- the shared discipline contract (applied per its applicability matrix, this skill runs the full battery)
Process
Step 1: Decision Guard (route before structuring)
Confirm this is actually a decision: two or more real courses of action, stakes, and someone who must choose. If it is understanding-seeking ("help me think about X") → /advise or /think-about-it. If it is a company-direction question canon already covers → /canon-advise governs; never relitigate a decided direction - /decide may still structure a new decision that canon leaves open (run one canon-mounted search BRAIN_READ_SCOPE=core,Canon when the subject smells like company direction; if a decision/spec note decides it, say so and stop).
Step 2: Frame the Decision
One block, before any retrieval:
- Decision statement - the choice in one sentence
- Decider + deadline - who chooses, by when, and what forces the timing (a decision with no deadline may be a defer candidate by default)
- Irreversibility horizon - what becomes hard to undo, and when
Step 3: Parallel Retrieval (one batch)
Same fast-path discipline as /advise - no subagents, static search, one parallel batch. Read role: reasoning (contract: scope-mount): two passes per term, core as the spine and the reasoning mount as the evidence layer; run the scope-mount trigger check first and append ,company / ,thinkers / ,Books/<slug> to the wide pass on a hit.
BRAIN_READ_SCOPE=core resources/local-brain-search/run_search.sh "[domain term 1]" --limit 3 --json
BRAIN_READ_SCOPE=core,Books,document-insights resources/local-brain-search/run_search.sh "[domain term 1]" --limit 5 --json
BRAIN_READ_SCOPE=core resources/local-brain-search/run_search.sh "[domain term 2]" --limit 3 --json
BRAIN_READ_SCOPE=core,Books,document-insights resources/local-brain-search/run_search.sh "[domain term 2]" --limit 5 --json
BRAIN_READ_SCOPE=core resources/local-brain-search/run_search.sh "[decision-structure term: ergodicity / optionality / reversibility / regret / explore exploit - match to the decision's shape]" --limit 3 --json
BRAIN_READ_SCOPE=core,Books,document-insights resources/local-brain-search/run_search.sh "[the same decision-structure term]" --limit 5 --json
resources/local-brain-search/run_connections.sh --hubs --json # fingerprint - always core; for the attractor checkThen read the 2-4 most relevant notes in parallel (frontmatter provenance: rides along for the checks).
Step 4: Expand the Option Set
The stated options are almost never the full set. Always add and assess:
- Status quo - explicitly, with its own costs (doing nothing is a choice)
- Defer - wait for information; a real option with a price (cost of delay) and a payoff (uncertainty resolved)
- Pilot / staged commitment - buy information while moving
- Hybrids - combinations the framing hid
Mark which options preserve optionality and which foreclose it.
Step 5: Classify the Decision (this selects the machinery)
| Axis | Question | Consequence |
| Reversibility | Two-way or one-way door? | One-way → more analysis, prefer option-preserving moves |
| Frequency | One-shot or repeated? | Repeated → play expected value; one-shot → tails dominate |
| Ruin exposure | Does any option carry an absorbing barrier (can't come back from the bad tail)? | Ergodic filter applies BEFORE any EV math |
| Uncertainty regime | Are probabilities honestly estimable (risk), or is this radical uncertainty? | Radical uncertainty → robustness/regret, NOT invented probabilities |
Step 6: Consequence Table + the Matching Rule
Build a compact table: options × the 2-4 uncertainties that actually drive the outcome. Probabilities only where estimable and reference-class anchored (Check 4); payoffs in natural units, not scores.
Then apply the rule the classification selected - in this order:
- Ergodic filter first - eliminate any option with ruin exposure regardless of its EV ("EV-positive but you can't survive the bad branch" is a losing bet by the user's own core framework). Name what it eliminated.
- Risk + repeated/reversible → expected-value decomposition - show the components, not just the total.
- Radical uncertainty → robustness + minimax regret - which option is acceptable across all live scenarios; which minimizes the worst regret. Do NOT fake point probabilities to force an EV number - saying "this is not probabilizable" is the Kay-King discipline, not a cop-out.
- Value of information - if defer/pilot resolves a driving uncertainty and the delay cost is tolerable, the real option can beat both stated options.
- Regret cross-check - long-lens (would the 10-year view flip this?). A cross-check, never the primary rule.
Step 7: Reasoning Checks (required - full battery)
Apply .claude/skills/reasoning-checks/SKILL.md:
- Epistemic Inversion on the recommendation - the pre-mortem is made for decisions; specific falsifier required
- Reference Class - required in practice (a decision embeds forecasts; anchor every estimated probability/magnitude)
- Attractor Check - against the hubs fetched in Step 3. Scope nuance: the check applies to the situation framing/diagnosis, not to the decision machinery itself - decision-science hubs (Decision Making, Ergodicity, Superforecasting) are this skill's tools by construction and do not count as attractor pull. What counts: the diagnosis leaning on 2+ top hubs.
- Provenance Base - from the notes read in Step 3
Step 8: Decision Brief (output)
## Decision: [one-line statement]
**Type:** [reversible? one-shot/repeated? ruin exposure? risk/radical uncertainty] → **Rule applied:** [ergodic filter → EV | robustness/minimax regret | value-of-information]
**Option set considered:** [stated + added options; which were eliminated and by what]
**Consequence table:** [options × driving uncertainties]
**Recommendation:** [the choice, produced by the named rule - and why the losing options lose]
**Tripwires (revisit if):**
- [observable condition → what it changes]
- [date-based checkpoint if the decision was defer/pilot]
**KB grounding:** [[Note 1]], [[Note 2]] - [how each shaped the structure]
[reasoning-checks blocks: Epistemic Inversion · Reference Class · Attractor Check · Provenance Base]On explicit request only: save the brief to Brain/05-Meta/Reports/decision-[slug]-YYYY-MM-DD.md (provenance: ai-inferred, standard frontmatter) - decision briefs are terminal deliverables, exactly what Reports/ is for. Never auto-save.
Rules
- NO subagent spawning - fast path, all inline
- Parallel batches - searches + hubs in one round, reads in one round; checks reuse those results
- The recommendation must name its rule - "this is an EV call" vs "this is a robustness call" is the whole point of the mode-switch; a recommendation with no named rule is
/adviseoutput wearing a costume - Never fake probabilities under radical uncertainty - the regime classification is honest or the machinery is theater
- Ruin trumps EV - the ergodic filter is not optional when an absorbing barrier is live
- Tripwires always - a decision brief without revisit conditions is a prediction, not a decision
- If the KB lacks relevant frameworks, say so and structure the decision from general principles, labelled as such
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

