policyengine-microsimulation

Compare baseline and reform scenarios with weighted MicroSeries outcomes.

2|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/PolicyEngine/policyengine-skills --skill policyengine-microsimulation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: policyengine-microsimulation
Source: https://github.com/PolicyEngine/policyengine-skills/tree/main/skills/tools-and-apis/policyengine-microsimulation-skill
Command: npx skills add https://github.com/PolicyEngine/policyengine-skills --skill policyengine-microsimulation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Policy analysis and budget forecasting for reform scenarios require robust, population-level impact assessments that correctly account for weighting and distribution across households and individuals. This skill provides an end-to-end microsimulation workflow to compare baseline and reform scenarios, producing weighted outcomes such as income, poverty, and budgetary effects.

Core Features & Use Cases

  • End-to-end microsimulation for national and state-level policy analyses.
  • Supports reforms through Reform objects and parameter exploration to assess fiscal and distributional impacts.
  • Generates weighted MicroSeries outputs (income, poverty indicators, inequality metrics) with entity mapping (household, person, SPMs) for downstream statistics.

Quick Start

Instantiate a baseline Microsimulation and a reform, run calc() on key variables for a chosen year, and compare the results.

Frequently Asked Questions about policyengine-microsimulation

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

FAQPage Schema
How do I calculate policy impacts at the population level using microsimulation?

To calculate policy impacts using microsimulation, instantiate a baseline scenario and a reform scenario, run calc() on key variables for a chosen year, and compare the weighted outcomes to measure distributional effects.

How does microsimulation compare baseline and reform scenarios for poverty and inequality metrics?

Microsimulation compares baseline and reform scenarios by calculating weighted outcomes for poverty and inequality metrics across households and individuals, generating MicroSeries outputs for downstream statistical analysis.

Can I run state-level microsimulation analyses for budgetary cost and distributional results?

Yes, you can run both national and state-level microsimulation analyses to assess budgetary costs and distributional results by comparing baseline and reform scenarios with correctly weighted population outcomes.

How do I handle entity mapping and weights when calculating reform impacts?

You must adhere to documented usage patterns by using calc and map_to for entity alignment across households, persons, and SPMs, ensuring correct weight handling to produce accurate weighted MicroSeries outputs.

What's the best way to measure budgetary and fiscal impacts of policy reforms using microsimulation?

The best way to measure budgetary impacts is by defining Reform objects and exploring parameters within the microsimulation to compare baseline scenarios against reforms, yielding weighted fiscal and distributional results.

Why do my weighted microsimulation results show misaligned entities across households and persons?

Misaligned entities occur when you fail to use the calc and map_to functions for proper entity alignment across households, persons, and SPMs, which is required to ensure correct weight handling and accurate MicroSeries outputs.