gitwtfhub

wtf is better-thinking?

skyf0xx/better-thinking — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 2/5Setup · easy

TL;DR

A Claude Code plugin that gives the AI over 130 structured thinking procedures and picks the right one automatically for each task.

Mindmap

mindmap
  root((Better Thinking))
    What it does
      135 thinking procedures
      Dispatcher picks method
      Structured not persona based
    Tech stack
      Claude Code plugin
      Markdown skills
      JSON index
    Use cases
      Decision analysis
      Root cause debugging
      Framework mapping
    Audience
      Claude Code users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run /better-thinking before a complex decision so Claude follows a structured procedure instead of guessing.

REASON 2

Trace a bug from its symptoms back to its root cause using a dedicated debugging skill.

REASON 3

Map a familiar framework like Design Thinking or Lean Startup onto a sequence of these skills using the included recipes.

REASON 4

Improve one atomic skill and have every composite workflow that depends on it get better automatically.

What's in the stack?

Claude CodeMarkdownJSON

How it stacks up

skyf0xx/better-thinking1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedevelopervibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Installs as a Claude Code plugin via a marketplace command, requires restarting the session to take effect.

The README does not state a license, so terms of use are unclear.

Wtf does this do

Better Thinking is a plugin for Claude Code that gives the AI a library of over 130 explicit thinking procedures to use instead of just being told to think harder. The idea behind it is that asking a model to think step by step does not reliably make it more careful, but giving it an actual structured method, like how to properly compare competing hypotheses or how to trace a bug back to its root cause, does. The plugin includes a dispatcher that figures out which of its 135 thinking procedures fits the task at hand, so the user does not need to memorize any skill names. A person just types a single command to start, and it looks at what is being asked, decides whether it is a decision, a diagnosis, research, or something else, and pulls in the right method at a depth that matches how much is riding on the answer. A quick low stakes question gets a fast check, while a costly and hard to reverse decision gets a fuller structured treatment. Each skill in the library encodes a step by step procedure rather than a persona to imitate. The skills are organized into two layers: atomic skills that implement one reasoning move on their own, such as forming hypotheses or steelmanning an argument, and composite skills that chain several atomic skills together into a larger workflow, such as a full scientific method or decision analysis process. This structure means improving one atomic skill benefits every composite workflow that relies on it. The project also ships a set of recipes that map well known frameworks people already use, like Design Thinking or Lean Startup, onto sequences of these skills stage by stage. It installs as a Claude Code plugin directly from GitHub using a marketplace command, and updates take effect the next time a session starts. This is aimed at anyone using Claude Code who wants more rigorous, checklist style reasoning on hard tasks rather than a generic think harder instruction.

Yoink these prompts

Prompt 1
Install the better-thinking plugin and run /better-thinking on this decision I'm facing.
Prompt 2
Use the better-thinking skill library to help me debug this issue from symptoms to root cause.
Prompt 3
Show me which better-thinking recipe maps onto the Lean Startup framework.
Prompt 4
Explain how the atomic and composite skills in better-thinking work together.

Frequently asked questions

wtf is better-thinking?

A Claude Code plugin that gives the AI over 130 structured thinking procedures and picks the right one automatically for each task.

What language is better-thinking written in?

Mainly Python. The stack also includes Claude Code, Markdown, JSON.

What license does better-thinking use?

The README does not state a license, so terms of use are unclear.

How hard is better-thinking to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is better-thinking for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.