Yao Bayesian Decision Skill β€” Structured Decision-Making for Claude Code

Yao Bayesian Decision Skill β€” Structured Decision-Making for Claude Code

The Yao Bayesian Decision Skill transforms complex, uncertain decisions into structured, iterative judgment processes. Instead of asking AI for a single answer, it guides you through multi-round dialogue where each round updates probability estimates based on new evidence. The output is a bilingual (Chinese/English) Markdown + HTML decision report showing the reasoning trail, judgment changes, and recommended actions.

Source: GitHub - yaojingang/yao-open-skills

How It Works

Incomplete input (your messy, real-world question)
       ↓
Initial assessment (establish weak prior assumptions)
       ↓
Prior selection (pick 3-5 relevant heuristics from 20 judgment principles)
       ↓
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚ Iterative rounds:  β”‚
  β”‚  Ask questions      β”‚ ← Multi-round dialogue
  β”‚  Gather evidence    β”‚
  β”‚  Update estimates   β”‚
  β”‚  Track what changed β”‚
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
           ↓
Decision readiness check (confidence level assessment)
       ↓
Final report (Markdown + bilingual HTML)

The key insight: it doesn’t wait for perfect information. It starts from incomplete input, builds weak priors, and iteratively strengthens the judgment through structured questioning β€” tracking exactly which evidence changed which estimates.

What Makes It Different

Traditional AI Decision Bayesian Skill
Single prompt β†’ single answer Multi-round dialogue β†’ evolving judgment
Black box reasoning Evidence attribution (which fact changed which estimate)
Assumes complete info Starts from incomplete input
One format Bilingual Markdown + interactive HTML
Static Iterative refinement with confidence tracking

Output Format

The skill generates:

  • Markdown report β€” decision process, judgment changes, and action items
  • Bilingual HTML (Chinese/English) β€” interactive with sticky navigation, language switching
  • Print-friendly PDF β€” exportable from browser
  • Evidence trail β€” which round introduced which information and how it shifted the judgment

Use Cases

The skill is designed for decisions where information is incomplete and risk is non-trivial:

  • Product decisions β€” Should we ship this feature this quarter?
  • Growth strategy β€” Which market should we enter first?
  • Career choices β€” Should I take this job offer?
  • Investment decisions β€” Is this startup worth investing in?
  • Personal decisions β€” Should I relocate? Buy or rent?
  • Research direction β€” Which hypothesis is worth pursuing?

Installation

# Add to Claude Code via skills protocol
npx skills add yaojingang/yao-open-skills

How LearnAI Team Could Use This

  • Teaching decision analysis β€” the iterative Bayesian framework is itself a pedagogical tool
  • Research planning β€” use it to systematically evaluate which research directions to pursue
  • Grant decisions β€” structure the β€œshould we apply for this grant?” analysis
  • Student advising β€” help students work through career and academic decisions systematically

Real-World Use Cases

  • Startup founders β€” structured pivot vs persist decisions
  • Product managers β€” feature prioritization under uncertainty
  • Researchers β€” hypothesis selection with explicit evidence tracking
  • Anyone facing a complex decision β€” the process forces you to articulate what you know, what you don’t, and what would change your mind