policyengine-user-guide

Compute tax and benefit policy impacts for households and populations via PolicyEngine.

31|6|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/PolicyEngine/policyengine-claude --skill policyengine-user-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: policyengine-user-guide
Source: https://github.com/PolicyEngine/policyengine-claude/tree/main/skills/policyengine-user-guide-skill
Command: npx skills add https://github.com/PolicyEngine/policyengine-claude --skill policyengine-user-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users need a clear, comprehensive guide to effectively navigate and utilize the PolicyEngine web application for household calculations and policy analysis. This Skill provides step-by-step instructions, empowering you to quickly understand and leverage the platform's full capabilities.

Core Features & Use Cases

  • Household Calculator: Step-by-step instructions for entering your information and viewing personalized tax and benefit results.
  • Policy Reform Creator: Guidance on designing custom policy proposals and understanding their population-wide impacts (budgetary, poverty, distributional, inequality).
  • Results Interpretation: Explanations of key metrics like SPM, Gini coefficient, and income deciles.
  • Use Case: Learn how to create a custom policy reform on policyengine.org, change the Child Tax Credit amount, and then view its impact on poverty rates and income distribution.

Quick Start

Use the policyengine-user-guide skill to explain how to calculate your household's taxes and benefits on policyengine.org/us/household.

Frequently Asked Questions about policyengine-user-guide

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

FAQPage Schema
How do I calculate my household's taxes and benefits on PolicyEngine?

Use PolicyEngine's household calculator to enter your income, household composition, location, and deductions at policyengine.org/us/household. The tool computes your net income, tax and benefit breakdowns, effective and marginal tax rates instantly.

What does PolicyEngine show me about tax and benefit impacts?

PolicyEngine outputs net income, itemized tax and benefit amounts, effective and marginal tax rates, and population-wide metrics including poverty rates, income distribution, and Gini coefficient for policy analysis across US, UK, and Canada.

How do I create and test a custom policy reform?

Design a custom policy proposal in PolicyEngine's reform creator, modify parameters like tax credits, and view population-wide budgetary, poverty, and distributional impacts. Share and evaluate reforms via the web app, Python client, or API.

Can I compare policy reforms across different household types?

Yes. PolicyEngine's household calculator and reform tools let you simulate policy changes across varying income levels, household compositions, and locations to assess distributional effects and inequality metrics like Gini coefficient.

What input data does PolicyEngine need for accurate calculations?

Provide income, household composition, location, and relevant deductions. PolicyEngine uses this data to compute personalized tax and benefit results and, when modeling reforms, aggregate outcomes for poverty and inequality analysis.

Does PolicyEngine work for policy analysis in the US, UK, and Canada?

Yes. PolicyEngine supports household-level calculations and population-wide reform simulations for United States, United Kingdom, and Canada, enabling tax and benefit policy analysis across these three contexts.