PolicyEngine

PolicyEngine/policyengine-claude

Command

Apply fixes to a PR based on /review-program findings or PR review comments.

PolicyEngine/policyengine-claude

Command

Generate social images and posts from a blog post or announcement.

PolicyEngine/policyengine-claude

Command

Calculate benefits, taxes, and net income for a single household under baseline or a reform — the standalone entry for household-level questions.

PolicyEngine/policyengine-claude

Command

Implements the model extension behind a STRUCTURAL /analyze-policy verdict — baseline change for enacted law, gov/contrib reform for proposals — opens the policyengine-{country} PR, and records the re-run that completes the original analysis.

PolicyEngine/policyengine-claude

Command

Scaffold a single-purpose interactive PolicyEngine tool (calculator or widget) — Next.js 14 + Tailwind 4 + ui-kit + embedding boilerplate. For multi-page policy analysis dashboards, use /create-dashboard.

PolicyEngine/policyengine-claude

Command

Search the local analyses archive for prior /analyze-policy runs — did we already score this? What did we conclude?

PolicyEngine/policyengine-claude

Command

Consult external scorekeepers (JCT, CBO, OBR, IFS, PBO, CRFB, TPC, etc.) for a reform without running the microsim.

PolicyEngine/policyengine-claude

Command

End-to-end reform pipeline in one command — scan the news for a modelable reform in a topic area, score and verify it with /analyze-policy (incl. the data-calibration check), then publish to the bill tracker or a dashboard.

PolicyEngine/policyengine-claude

Command

Review any PR — code validation + PDF audit in one pass (read-only, no code changes).

PolicyEngine/policyengine-claude

Command

Install PolicyEngine-themed spinner verbs into your Claude Code settings.

PolicyEngine/policyengine-claude

Command

Convert a bill / URL / natural-language description into a validated reform-dict — Stage 1+2 of /analyze-policy without running the microsim.

PolicyEngine/policyengine-claude

Command

Write unit tests for source files, matching the target repo's observed test conventions.

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Use when the user invokes $encode-policy-v2 or asks Codex or Claude Code to implement a new PolicyEngine-US state benefit program or a new structural program component from official rules. Covers existing-program routing, source collection and full PDF rendering, user-approved scope, implementation, tests, validation…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Use when the user invokes $fix-pr or asks Codex or Claude Code to apply fixes to a PolicyEngine PR based on $review-program findings, GitHub review comments, CI failures, or local review reports.

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Load when consuming or developing the PolicyEngine REST APIs — the v1 Flask API at api.policyengine.org (production today) or the v2 alpha microservices in policyengine-api-v2. Covers the v1 endpoint surface (household calc, economy-over-baseline polling), the v2 architecture (three services, uv/Docker/Cloud Run…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Load when developing policyengine-app-v2 — the site served at policyengine.org. Covers the bun/turbo monorepo, the Next.js 15 App Router host in website/, the legacy Vite SPA in app/ being migrated, ui-kit + designTokens theming, multizone rewrites, and how the frontend calls the PolicyEngine API. Triggers…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Sensitivity registry for PolicyEngine microsim results — maps {program x deviation signature} to the calibration target or imputed variable most likely driving a mismatch, and reads the live per-target diagnostics for the current Microcosm release. The knowledge base behind the calibration-diagnostics agent and…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

How to compute Canadian household tax/benefit outcomes with PolicyEngine, and the hard limits. Load when a task involves Canadian taxes or benefits (CCB, GST/HST credit, CWB, OAS, provincial tax) at the household level. Key facts: pe.ca does NOT exist — Canada is not in the policyengine wrapper; use the…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Generate branded social assets from a PolicyEngine blog post or announcement — 1200x630 social images and platform-optimized post copy for LinkedIn/X, localized for UK/US audiences. Triggers: "make a social image", "social card for this post", "generate content", "LinkedIn post for", "X post for", "promote this blog…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Load for PolicyEngine's data layer — how the microdata behind population microsimulations is built, calibrated, versioned, and named. Covers the Microcosm stack (Frame kernel, microcosm-fit conditional models, microcosm-calibrate weights with L0 sparsity, build/release gates), the certified datasets that flow into…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Load when styling any PolicyEngine frontend — choosing colors, fonts, spacing, chart colors, or consuming @policyengine/ui-kit. Covers the two-import globals.css, the three-layer theme.css (@theme vs @theme inline), verified 0.4.0 token values and component exports, the dark-mode contract, and the Plotly chart house…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Working with the PolicyEngine GitHub agent bot on issues and PRs — how it is invoked and the hard rule that keeps it from looping. Load before replying to, or posting as, the bot. Triggers: "@policyengine bot", "GitHub agent", "policyengine-github-agent", "bot doom loop", "bot mentioned itself", "who can invoke the…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

US healthcare domain knowledge (Medicaid, ACA premium tax credit, CHIP, Medicare) for analysts using the policyengine package. Load for: why ACA PTC and Medicaid changes show $0 in householdnetincome (the includehealthbenefitsinnetincome gotcha) and how to measure health impact instead; the acaptc / medicaid /…

PolicyEngine/policyengine-claude

Skill Claude CodeCodex

Load when editing a PolicyEngine country model repo (policyengine-us, policyengine-uk, policyengine-canada) — adding or changing variables, parameters, YAML tests, or contributed reforms. This is the engineering layer (how formulas, parameter YAML, and tests are written), distinct from running analysis. Triggers: add…