$npx -y skills add HoangTheQuyen/think-better --skill make-decisionAI-powered decision-making framework: 10+ methodologies, cognitive bias detection, strategic planning, career & business decisions. Use when user says "decide", "choose", "compare", "which one", "should I", "weigh options", "trade-off", "pros and cons", "help me pick", "evaluate"
| 1 | # Goal |
| 2 | |
| 3 | Help users make better decisions in minutes instead of hours by applying proven frameworks, detecting cognitive biases, and structuring the evaluation process. |
| 4 | |
| 5 | # make-decision |
| 6 | |
| 7 | Comprehensive decision-making framework for structured evaluation of options. Contains 10 decision frameworks, 8 decision type classifications, 12 cognitive biases with debiasing strategies, 10 analysis techniques, 8 domain-specific criteria templates, and 8 group facilitation techniques. Searchable knowledge base with BM25 ranking that auto-recommends frameworks, criteria, and bias warnings tailored to your specific decision type. |
| 8 | |
| 9 | ## Prerequisites |
| 10 | |
| 11 | **IMPORTANT: Detect the correct Python command first.** Some systems use `python3`, others use `python`. Run: |
| 12 | |
| 13 | ```bash |
| 14 | python3 --version 2>/dev/null || python --version |
| 15 | ``` |
| 16 | |
| 17 | Use whichever command succeeds (`python3` or `python`) for ALL script calls below. If the system only has `python` (common on Windows), substitute `python` everywhere you see `python3` in this document. |
| 18 | |
| 19 | If Python is not installed at all, install it based on user's OS: |
| 20 | |
| 21 | **macOS:** |
| 22 | ```bash |
| 23 | brew install python3 |
| 24 | ``` |
| 25 | |
| 26 | **Ubuntu/Debian:** |
| 27 | ```bash |
| 28 | sudo apt update && sudo apt install python3 |
| 29 | ``` |
| 30 | |
| 31 | **Windows:** |
| 32 | ```powershell |
| 33 | winget install Python.Python.3.12 |
| 34 | ``` |
| 35 | |
| 36 | > **Note:** On Windows, Python 3 is typically available as `python` (not `python3`). |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## How to Use This Workflow |
| 41 | |
| 42 | When user requests decision-making help (decide, choose, compare, evaluate, select, prioritize, trade-off, weigh options), follow this workflow: |
| 43 | |
| 44 | ### Step 1: Understand the Decision |
| 45 | |
| 46 | Extract key information from user's decision description: |
| 47 | - **Decision type**: Binary choice, multi-option, resource allocation, strategic, operational, under uncertainty, group/stakeholder, time-pressured |
| 48 | - **Options**: What alternatives are being considered? |
| 49 | - **Context**: Industry, stakes, timeline, stakeholders, reversibility |
| 50 | - **Constraints**: Budget, time, resources, dependencies |
| 51 | |
| 52 | ### Step 2: Generate Decision Plan (REQUIRED) |
| 53 | |
| 54 | **Always start with `--plan`** to get comprehensive recommendations: |
| 55 | |
| 56 | ```bash |
| 57 | python3 scripts/search.py "<decision_description>" --plan [-p "Project Name"] |
| 58 | ``` |
| 59 | |
| 60 | This command: |
| 61 | 1. Classifies the decision type automatically |
| 62 | 2. Searches across all 6 knowledge domains |
| 63 | 3. Recommends the best framework for this type of decision |
| 64 | 4. Identifies relevant evaluation criteria with weights |
| 65 | 5. Warns about cognitive biases likely to affect this decision |
| 66 | 6. Suggests analysis techniques and facilitation methods |
| 67 | 7. Includes anti-patterns to avoid and a decision checklist |
| 68 | |
| 69 | **Example:** |
| 70 | ```bash |
| 71 | python3 scripts/search.py "choosing between AWS and Azure for cloud migration" --plan -p "Cloud Migration" |
| 72 | ``` |
| 73 | |
| 74 | ### Step 2b: Persist Decision Plan |
| 75 | |
| 76 | To save the plan for reference: |
| 77 | |
| 78 | ```bash |
| 79 | python3 scripts/search.py "<decision>" --plan --persist -p "Project Name" |
| 80 | ``` |
| 81 | |
| 82 | This creates: |
| 83 | - `decision-plans/project-name/PLAN.md` — Complete decision-making plan |
| 84 | |
| 85 | ### Step 3: Deep-Dive Domain Searches |
| 86 | |
| 87 | Use when the plan's recommendation needs more detail, OR when user asks about a specific topic (e.g., "what biases should I watch for?"): |
| 88 | |
| 89 | ```bash |
| 90 | python3 scripts/search.py "<keyword>" --domain <domain> [-n <max_results>] |
| 91 | ``` |
| 92 | |
| 93 | **When to use domain searches:** |
| 94 | |
| 95 | | Need | Domain | Example | |
| 96 | |------|--------|---------| |
| 97 | | Choose a decision framework | `frameworks` | `--domain frameworks "hypothesis uncertainty"` | |
| 98 | | Classify the decision type | `types` | `--domain types "binary strategic"` | |
| 99 | | Identify cognitive biases | `biases` | `--domain biases "confirmation sunk cost"` | |
| 100 | | Select analysis techniques | `analysis` | `--domain analysis "sensitivity break-even"` | |
| 101 | | Get evaluation criteria | `criteria` | `--domain criteria "technology vendor"` | |
| 102 | | Plan group facilitation | `facilitation` | `--domain facilitation "pre-mortem red team"` | |
| 103 | |
| 104 | ### Step 4: Compare Options |
| 105 | |
| 106 | Use when user has 2+ named options to compare (e.g., "A vs B vs C"). Generate a comparison matrix: |
| 107 | |
| 108 | ```bash |
| 109 | python3 scripts/search.py --matrix "AWS vs Azure vs GCP" [-c "cost,scalability,security"] |
| 110 | ``` |
| 111 | |
| 112 | This generates a weighted comparison matrix with criteria auto-suggested from templates (or custom criteria via `-c`), scoring guide, and calculation instructions. |
| 113 | |
| 114 | ### Step 5: Document the Decision |
| 115 | |
| 116 | Use after reaching a conclusion. Creates a journal entry for future reflection and calibration: |
| 117 | |
| 118 | ```bash |
| 119 | # Create journal entry |
| 120 | python3 scripts/search.py --journal "Choosing cloud provider for Q3 migration" |
| 121 | |
| 122 | # Review past decision |