Official Claude Code plugin for PolicyEngine development - agents, commands, and skills for tax/benefit microsimulation
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…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
Maintaining the policyengine-skills source repo and its generated policyengine-claude wrapper — adding or editing skills, bundles, and the Claude/Codex targets, and keeping the verification harness green. For maintaining the catalog, not for using PolicyEngine. Triggers: "update plugin", "add a skill", "edit a…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
Curated anchor list of PolicyEngine's previously-published scored reforms, plus the map of the real prior-scores infrastructure in this repo (presets, the scorekeepers registry, the /prior-scores command, and the prior-scores-finder agent). Use to find a benchmark magnitude to anchor a new analysis (Stage 3 / Stage 5…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
Find and cite PolicyEngine's published blog posts and research articles as evidence or proof points — for talks, pitches, grant narratives, and "has PolicyEngine written about X?" Triggers: "find a blog post", "PolicyEngine research on", "published analysis", "proof point", "has PolicyEngine written about", "cite our…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
PolicyEngine coding standards, environment setup, formatters, changelog, and CI requirements across every repo — what makes a PR pass and merge cleanly. Covers uv + .venv, ruff, bun, towncrier changelog fragments, the "wait for CI" PR pattern, and the repo-rename checklist. Triggers: "CI failing", "linting"…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
Load when building a standalone PolicyEngine interactive tool, calculator, or dashboard that deploys to Vercel and embeds into policyengine.org as a Next.js multizone. Covers the required stack (Next App Router + Tailwind v4 + @policyengine/ui-kit + bun), multizone zone config (basePath/assetPrefix, host rewrites…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
Load before writing PolicyEngine-UK code — UK household calculations, income tax (incl. Scottish and Welsh variations), National Insurance, Universal Credit and other benefits, poverty and reform analysis. Covers the person/benunit/household entity model (UK has NO taxunit), pe.uk.calculatehousehold, BHC vs AHC…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
US tax-benefit domain knowledge for analysts computing household or population impacts with the policyengine package (pe.us). Load for: which entity a US program attaches to (taxunit vs spmunit vs person), tax-unit role flags and filing status, post-OBBBA current-law values (2026 CTC, standard deduction, SALT cap)…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
Using the PolicyEngine web app (policyengine.org) to analyze how tax and benefit reforms affect a household or the whole population — the household calculator, the policy editor, and society-wide impact charts. For people using the site, not building it. Triggers: "how to use PolicyEngine", "household calculator"…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
PolicyEngine writing style for any public-facing prose — blog posts, research reports, documentation, PR descriptions, social copy, READMEs. Enforces active voice, quantitative precision, sentence-case headings, and the analytical neutrality a nonpartisan 501(c)(3) requires: no policy prescriptions dressed as…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
ALWAYS load this skill before writing any Python that computes taxes, benefits, or policy impacts with PolicyEngine — household calculations, microsimulation, reform scoring, poverty or distributional analysis, state/district/constituency breakdowns. Triggers: policyengine, microsimulation, calculatehousehold, reform…
PolicyEngine/policyengine-claude
Skill Claude CodeCodex
ALWAYS LOAD THIS SKILL for PolicyEngine PR reviews, including when the user invokes $review-program or Codex /review on a PolicyEngine PR. Performs read-only code validation, source-reference checks, regulatory review, optional PDF audit, summary reporting, and optional GitHub comment posting.