think-better

skill
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 103 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in build.sh
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool injects structured decision-making frameworks and cognitive bias detectors into AI prompts, helping models generate rigorous, well-analyzed responses rather than generic answers.

Security Assessment
The tool poses a Medium overall risk. The primary concern is its installation method: it instructs users to pipe remote shell scripts directly into bash or PowerShell (`curl ... | bash`). While common, this practice is inherently dangerous if the remote repository is ever compromised. Furthermore, the automated scan flagged a recursive force deletion command (`rm -rf`) inside a build script, which can be destructive if executed in an unexpected environment or if a path variable is flawed. There are no hardcoded secrets, no dangerous permissions requested, and no indication that the tool itself accesses sensitive local data. However, users should be aware that it is designed to intercept and process your conversational AI prompts.

Quality Assessment
The project is in excellent health and shows strong signs of community validation. It is actively maintained, with repository updates pushed as recently as today. It has garnered over 100 GitHub stars, indicating solid community trust for a niche utility. The code is fully open-source and distributed under the standard, permissive MIT license. The documentation is clear, thorough, and provides multiple installation paths.

Verdict
Use with caution: the functional tool itself is safe and well-maintained, but you should review the installer and build scripts before execution to mitigate the risks of remote script execution and force deletion commands.
SUMMARY

The Operating System for Clear Thinking & Better Decisions

README.md
Think Better

Think Better

Your AI writes code fast but makes terrible decisions.

Think Better injects structured decision frameworks directly into your AI prompts.

Go 1.25
License: MIT
2 AI Skills
10+ Frameworks
15 Decomposition
12 Biases
4 Depth Levels

Website · Documentation · Quick Reference · Contributing

Works with Claude · GitHub Copilot · Antigravity


The Problem

You ask your AI "Should we migrate to microservices?" and get a generic pros/cons list. No framework. No bias detection. No structured analysis. Just vibes.

Think Better fixes this. It gives your AI access to 10 decision frameworks, 15 decomposition methods, 12 cognitive bias detectors, and 160 knowledge records — turning surface-level responses into structured, rigorous analysis.


Quick Start

# macOS / Linux
curl -sSL https://raw.githubusercontent.com/HoangTheQuyen/think-better/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/HoangTheQuyen/think-better/main/install.ps1 | iex

Then install skills for your AI:

think-better init --ai claude        # Claude Code
think-better init --ai copilot       # GitHub Copilot
think-better init --ai antigravity   # Antigravity

Other install methods: go install github.com/HoangTheQuyen/think-better/cmd/make-decision@latest or clone & make build


How It Works

Just talk to your AI naturally. Think Better auto-activates when it detects a decision or problem:

You: "Should we migrate from React to Next.js for our main app?"

AI:  → Detects: Binary Choice
     → Framework: Reversibility Filter
     → Warns: Overconfidence Bias, Status Quo Bias, Sunk Cost
     → Generates: Weighted comparison matrix + action plan
You: "Revenue dropped 20% despite market growth"

AI:  → Detects: Opportunity Gap
     → Decomposition: Profitability Tree (MECE)
     → Analysis: Root Cause (5 Whys) + Fermi Estimation
     → Warns: Anchoring Bias, Confirmation Bias

Two Skills

/decide — For Choices

"choose", "compare", "should I", "pros and cons", "nên chọn cái nào", "phân vân"

10 Frameworks Reversibility Filter, Weighted Matrix, Hypothesis-Driven, Pre-Mortem, Pros-Cons-Fixes...
12 Bias Warnings Overconfidence, Anchoring, Sunk Cost, Status Quo, Confirmation...
Comparison Matrix --matrix "A vs B vs C" with weighted scoring
Decision Journal Track → Review → Improve calibration

/solve — For Problems

"solve", "debug", "root cause", "I'm stuck", "tại sao bị vậy", "không biết làm sao"

7-Step Method Define → Decompose → Prioritize → Analyze → Synthesize → Communicate
15 Decomposition Frameworks Issue Tree, MECE, Hypothesis Tree, Profitability Tree, Systems Map...
12 Mental Models First Principles, Inversion, Bayesian Updating, Pareto...
10 Communication Patterns Pyramid Principle, BLUF, SCR, Action Titles...

Depth Levels

Control analysis depth with slash commands:

Command Depth Records Best For
/solve.quick · /decide.quick Quick 0.5× Fast scan, simple problems
/solve · /decide Standard 1.0× Default for most situations
/solve.deep · /decide.deep Deep 1.7× Complex, high-stakes decisions
/solve.exec · /decide.exec Executive 2.5× Board reports, stakeholder briefings

Examples:

/solve.quick API latency spiked after deploy
/decide.deep AWS vs Azure vs GCP for cloud migration
/solve.exec Revenue declined 20% quarter over quarter

Architecture

YOU ─── "Revenue dropped 20%" ──────────────────────────────────┐
                                                                │
  ┌─────────────────────────────────────────────────────────────▼──┐
  │  AI ASSISTANT (Claude / Copilot / Antigravity)                 │
  │                                                                │
  │  ┌─ Auto-detect ──────────┐    ┌─ Slash Command ────────────┐ │
  │  │ SKILL.md triggers      │ OR │ /solve.deep → deep mode    │ │
  │  │ "solve" → problem-pro  │    │ /decide.quick → quick mode │ │
  │  └────────────┬───────────┘    └────────────┬───────────────┘ │
  │               └───────────┬────────────────┘                  │
  │                           ▼                                    │
  │  ┌────────────────────────────────────────────────────────┐   │
  │  │  🐍 BM25 Search Engine                                 │   │
  │  │  160 records × depth multiplier (0.5× → 2.5×)         │   │
  │  └────────────────────────┬───────────────────────────────┘   │
  │                           ▼                                    │
  │  ┌────────────────────────────────────────────────────────┐   │
  │  │  📋 Advisor Engine                                      │   │
  │  │  Classify → Framework → Bias Detection → Plan          │   │
  │  └────────────────────────┬───────────────────────────────┘   │
  │                           ▼                                    │
  │  📄 Structured Output + Next-step suggestions                 │
  └───────────────────────────────────────────────────────────────┘

Step-by-Step Workspace

Add "save step-by-step" to any prompt to generate a full markdown workspace:

solving-plans/project/               decision-plans/project/
├── 00-OVERVIEW.md                   ├── 00-OVERVIEW.md
├── 01-PROBLEM-DEFINITION.md         ├── 01-DECISION-TYPE.md
├── 02-DECOMPOSITION.md              ├── 02-FRAMEWORK.md
├── 03-PRIORITIZATION.md             ├── 03-CRITERIA.md
├── 04-ANALYSIS-PLAN.md              ├── 04-ANALYSIS.md
├── 05-FINDINGS.md                   ├── 05-OPTIONS.md
├── 06-SYNTHESIS.md                  ├── 06-DECISION.md
├── 07-RECOMMENDATION.md             ├── BIAS-WARNINGS.md
├── BIAS-WARNINGS.md                 └── DECISION-LOG.md
└── DECISION-LOG.md

CLI Commands

think-better init             # Install skills for your AI
think-better list             # Show installed skills
think-better check            # Verify prerequisites (Python 3)
think-better uninstall        # Remove skills
think-better version          # Show version

Project Structure

think-better/
├── cmd/make-decision/           # CLI entry point (Go)
├── internal/                    # Core logic
│   ├── skills/                  # Skill registry + embedded data
│   ├── targets/                 # AI platform definitions
│   ├── installer/               # Install/uninstall logic
│   └── cli/                     # Command handlers
├── .agents/
│   ├── skills/
│   │   ├── make-decision/       # Decision skill (SKILL.md, scripts, CSVs)
│   │   └── problem-solving-pro/ # Problem-solving skill
│   └── workflows/               # Slash command definitions
└── specs/                       # Specifications

Stats: 13 Go files · 7 Python scripts · 16 CSVs (160 records) · 8 workflows


Requirements

Method Requirements
Binary download None — just run
go install Go 1.25+
Build from source Go 1.25+
Running skills Python 3

Contributing

See CONTRIBUTING.md for guidelines.



🇻🇳 Tiếng Việt

Ngừng Đoán Mò. Bắt Đầu Tư Duy Có Cấu Trúc.

AI viết code nhanh nhưng ra quyết định tệ.

Think Better tiêm framework tư duy vào prompt — biến AI thành Staff Engineer.

Cài Đặt

# macOS / Linux
curl -sSL https://raw.githubusercontent.com/HoangTheQuyen/think-better/main/install.sh | bash

# Windows
irm https://raw.githubusercontent.com/HoangTheQuyen/think-better/main/install.ps1 | iex

# Cài skill
think-better init --ai claude

Cách Dùng

Nói chuyện với AI bình thường — Think Better tự kích hoạt:

Bạn Nói AI Làm
"Nên chọn công ty lớn hay startup?" make-decision → Weighted Matrix, cảnh báo Status Quo Bias
"So sánh React vs Vue vs Angular" Bảng so sánh với tiêu chí có trọng số
"Tại sao doanh thu giảm?" problem-solving-pro → Issue Tree, Root Cause Analysis
"Bị kẹt, không biết làm sao" 7 bước: Định nghĩa → Phân tách → Ưu tiên → Phân tích

2 Skill

/decide — Chọn lựa

  • 10 framework · 12 bias · So sánh đa tiêu chí · Nhật ký quyết định

/solve — Giải quyết vấn đề

  • 7 bước McKinsey · 15 framework phân tách · 12 mô hình tư duy

Slash Commands

Lệnh Khi Nào
/solve.quick · /decide.quick Scan nhanh
/solve · /decide Phân tích chuẩn
/solve.deep · /decide.deep Phức tạp, high-stakes
/solve.exec · /decide.exec Báo cáo cho leadership
/solve.quick API chậm sau deploy
/decide.deep Nên dùng AWS hay Azure hay GCP?

Lưu Ý

  • Knowledge base tiếng Anh — AI tự dịch keyword trước khi search
  • Cần Python 3 cho script phân tích
  • Hỗ trợ Claude, Copilot, Antigravity

MIT License · Built by HoangTheQuyen

⭐ Star if Think Better helped you think better.

Reviews (0)

No results found