active-inference

Select actions by minimizing Expected Free Energy in partially observable environments.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/thistleknot/skills --skill active-inference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: active-inference
Source: https://github.com/thistleknot/skills/tree/main/active-inference
Command: npx skills add https://github.com/thistleknot/skills --skill active-inference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Active Inference helps an agent decide what to do next when the true state is hidden and there is no reliable scalar reward signal to guide exploration.

Core Features & Use Cases

  • Bayesian decision-making without rewards: selects actions by minimizing Expected Free Energy, balancing epistemic value (information gain) and pragmatic value (preference satisfaction).
  • Generative model for partially observable environments: uses likelihood (A), transition (B), preferences (C), and priors (D) with variational inference to update beliefs from observations.
  • Principled tool selection and debugging workflows: drives probing actions (e.g., searches, targeted reads, test runs) based on which action most reduces uncertainty before committing to fixes.

Quick Start

Use this skill to build a small active-inference agent that models hidden causes of a bug and chooses the next tool action (like searching a file or running tests) that most reduces diagnostic uncertainty until you reach a confident conclusion.

Frequently Asked Questions about active-inference

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

FAQPage Schema
How do I choose actions under uncertainty without a scalar reward signal?

Action selection under uncertainty without a scalar reward is achieved by active inference, which minimizes Expected Free Energy to balance information gain and preference satisfaction.

What is active inference for action selection in partially observable environments?

Active inference is a Bayesian decision-making approach for POMDP-like environments that uses variational state inference and Expected Free Energy to select actions that reduce diagnostic uncertainty.

How do I set up a generative model for agent planning with partial observability?

Setting up a generative model for agent planning requires defining likelihood, transition, preference, and prior matrices to update beliefs from observations and drive uncertainty-minimizing actions.

Can I apply active inference to diagnostic tool selection and debugging workflows?

Active inference applies to debugging workflows by driving probing actions such as targeted file searches or test runs based on which action most reduces diagnostic uncertainty before committing fixes.

What planning modes are supported for policy selection in active inference agents?

Policy selection in active inference agents supports planning modes including flat inference, sophisticated inference, and MCTS, selecting policies by evaluating Expected Free Energy across possible actions.

When should I avoid using Expected Free Energy for action selection?

Expected Free Energy minimization requires a valid generative model with defined matrices, making it unsuitable for environments where reliable likelihood, transition, preference, or prior distributions cannot be constructed.