bayes-reasoner

Balance competing hypotheses to identify the most probable root cause under uncertainty.

Updated Dec 1, 2025
One-click install
npx skills add https://github.com/NiloCK/bayes-reasoner --skill bayes-reasoner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bayes-reasoner
Source: https://github.com/NiloCK/bayes-reasoner/tree/main
Command: npx skills add https://github.com/NiloCK/bayes-reasoner --skill bayes-reasoner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Balances competing hypotheses to identify the most probable root cause under uncertainty, reducing cognitive bias during diagnostics.

Core Features & Use Cases

  • Initialize hypotheses with automatic normalization and an explicit "Other" option to account for unlisted causes.
  • Define tests with likelihoods, update beliefs based on evidence, and obtain information-gain-driven recommendations.
  • View and manage the current state, split complex hypotheses into subcategories, and inject new hypotheses as evidence warrants.

Quick Start

Initialize with a set of hypotheses and then define tests and run a recommendation for the most informative next step.

Frequently Asked Questions about bayes-reasoner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I weigh competing hypotheses to find the root cause of an incident?

Bayesian hypothesis balancing identifies the most probable root cause by updating beliefs based on evidence, reducing cognitive bias during incident investigations with sparse data. You initialize competing hypotheses, define diagnostic tests, and update probabilities as evidence arrives.

How does probabilistic reasoning handle unlisted causes during incident investigations?

Probabilistic reasoning handles unlisted causes through automatic normalization and an explicit "Other" hypothesis option, ensuring unaccounted root causes maintain probability mass. This prevents overconfidence in listed hypotheses when conducting incident investigations with incomplete information.

What's the best way to determine the most informative next diagnostic test under uncertainty?

Information-gain-driven recommendations identify the most informative next diagnostic step by calculating which test most effectively differentiates between remaining hypotheses. The system evaluates defined test likelihoods against current hypothesis probabilities to recommend the highest-value diagnostic action.

Can I split complex hypotheses into subcategories during an active investigation?

Yes, you can split complex hypotheses into subcategories during an active investigation using the split capability. This allows refining broad root cause hypotheses into more specific sub-hypotheses as evidence warrants, maintaining normalized probabilities across the expanded diagnostic state.

When should I inject new hypotheses into a probabilistic diagnostics workflow?

Inject new hypotheses when emerging evidence suggests a root cause not covered by existing options. The inject capability adds new hypotheses to the active state without resetting prior diagnostic progress, allowing the investigation to adapt as information expands beyond initial assumptions.

Does hypothesis balancing require external dependencies or cloud services?

No external dependencies or cloud services are required. The probabilistic reasoning engine operates entirely locally via a Python CLI and stores investigation state in a local JSON file, making it suitable for offline incident response and sensitive diagnostic workflows.