Agent skill
policyengine-research-lookup
Find and reference PolicyEngine blog posts, research articles, and published analyses for evidence and proof points. Triggers: "find blog post", "PolicyEngine research", "published analysis", "proof point", "has PolicyEngine written about", "blog post about"
Install this agent skill to your Project
npx add-skill https://github.com/PolicyEngine/policyengine-claude/tree/main/skills/documentation/policyengine-research-lookup-skill
SKILL.md
PolicyEngine Research Lookup
Use this skill to find existing PolicyEngine research, blog posts, and published analyses that can serve as evidence, proof points, or references.
For Users
What is PolicyEngine Research?
PolicyEngine publishes research through:
- Blog posts: Policy analyses, model updates, methodology explanations
- Research reports: In-depth studies for partners and stakeholders
- Dashboards: Interactive tools for specific policy questions
Key Research Highlights
Government adoption:
- Our CTO spent 6 months at 10 Downing Street adapting PolicyEngine for UK government use (see
policyengine-10-downing-street.md)
State coverage:
- US model covers federal + state taxes for all 50 states
- State-specific posts: California, New York, Kansas, Montana, Oregon, Utah, Washington, Minnesota
UK coverage:
- Full UK tax-benefit system
- Autumn Budget analyses, manifesto costing
For Analysts
Finding Blog Posts
Location in codebase:
~/policyengine-app-v2/app/src/data/posts/articles/
Search for topics:
# Find posts mentioning a topic
find ~/policyengine-app-v2/app/src/data/posts/articles/ -name "*.md" | \
xargs grep -l -i "topic" 2>/dev/null
# List all posts
ls ~/policyengine-app-v2/app/src/data/posts/articles/
Post metadata is in:
~/policyengine-app-v2/app/src/data/posts/posts.json
Key Posts to Reference
| Topic | File | Use Case |
|---|---|---|
| Government adoption | policyengine-10-downing-street.md |
Credibility, state capacity |
| State tax models | state-tax-model-beta.md |
US state coverage |
| Machine learning | Various | Accuracy, methodology |
| Budget analyses | autumn-budget-*.md |
UK policy coverage |
| US tax proposals | *-tax-*.md, *-ctc-*.md |
Federal policy coverage |
Post Structure
Each post is markdown with YAML frontmatter:
---
title: "Post Title"
date: "2025-01-15"
authors:
- name: Author Name
tags:
- us
- federal
---
For Contributors
When to Use This Skill
- Preparing talks, pitches, or presentations about PolicyEngine
- Finding proof points for PolicyEngine's credibility
- Referencing specific analyses in conversations
- Looking up methodology explanations
- Finding state or country-specific coverage
Common Lookups
"What's our strongest credibility proof point?" → 10 Downing Street blog post: CTO spent 6 months adapting PolicyEngine for UK government
"Do we cover [state] taxes?" → Search for state name in posts directory; also check policyengine-us-skill
"What did we write about [policy]?" → Search posts directory for policy name or related terms
"Where can I find our methodology for [X]?" → Search for technical posts; check also policyengine-core-skill
Adding New Research References
When PolicyEngine publishes significant new research:
- Note the filename in this skill if it's a key proof point
- Update the "Key Posts to Reference" table above
- Consider if it warrants mention in related skills (e.g., country skills)
Resources
- Blog posts:
~/policyengine-app-v2/app/src/data/posts/articles/ - Post index:
~/policyengine-app-v2/app/src/data/posts/posts.json - Live blog: https://policyengine.org/us/blog and https://policyengine.org/uk/blog
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
policyengine-healthcare
Healthcare program modeling in PolicyEngine-US — Medicaid, ACA marketplace, CHIP, and Medicare. Covers encoding rules, running analyses, and navigating the unique complexity of US healthcare programs. Triggers: "healthcare", "health insurance", "Medicaid", "ACA", "CHIP", "Medicare", "marketplace", "premium tax credit", "APTC", "PTC", "SLCSP", "benchmark plan", "rating area", "age curve", "family tier", "coverage gap", "Medicaid expansion", "MAGI", "medicaid_magi", "aca_magi", "medicaid_income_level", "medicaid_category", "enrollment", "takeup", "take-up", "per capita", "CSR", "cost sharing", "insurance premium", "second lowest silver", "required contribution percentage", "42 CFR", "IRC 36B", "categorical eligibility", "expansion adult", "healthcare reform", "healthcare analysis", "health policy".
policyengine-us
ALWAYS LOAD THIS SKILL FIRST before writing any PolicyEngine-US code. Contains the correct API patterns for household calculations and population simulations using the new policyengine package. Covers US federal and state taxes/benefits. Triggers: "what would", "how much would a", "benefit be", "eligible for", "qualify for", "single parent", "married couple", "family of", "household of", "if they earn", "earning $", "making $", "calculate benefits", "calculate taxes", "benefit for a", "what would I get", "what is the maximum", "what is the rate", "poverty line", "income limit", "benefit amount", "maximum benefit", "compare states", "TANF", "SNAP", "EITC", "CTC", "SSI", "WIC", "Section 8", "Medicaid", "ACA", "child tax credit", "earned income", "supplemental security", "housing voucher", "microsimulation", "population", "reform", "policy impact", "budgetary", "decile".
policyengine-uk
ALWAYS LOAD THIS SKILL FIRST before writing any PolicyEngine-UK code. Contains the correct API patterns for household calculations and population simulations using the new policyengine package (not policyengine_uk directly). Triggers: "what would", "how much would a", "benefit be", "eligible for", "qualify for", "single parent", "married couple", "family of", "household of", "if they earn", "with income of", "earning £", "making £", "calculate benefits", "calculate taxes", "benefit for a", "tax for a", "what would I get", "what would they get", "what is the rate", "what is the threshold", "personal allowance", "maximum benefit", "income limit", "benefit amount", "how much is", "Universal Credit", "child benefit", "pension credit", "housing benefit", "council tax", "income tax", "national insurance", "JSA", "ESA", "PIP", "disability living allowance", "working tax credit", "child tax credit", "Scotland", "Wales", "UK", "microsimulation", "population", "reform", "policy impact", "budgetary", "decile".
policyengine-canada
ALWAYS LOAD THIS SKILL FIRST before writing any PolicyEngine-Canada code. Contains Canadian federal and provincial tax/benefit rules for household calculations. IMPORTANT: PolicyEngine-Canada does NOT have representative population microdata. Do NOT attempt microsimulation or population-level estimates for Canada. Only provide household-level analysis (single-family impacts, eligibility, benefit amounts). Triggers: "what would", "how much would a", "benefit be", "eligible for", "qualify for", "single parent", "married couple", "family of", "household of", "if they earn", "earning $", "making $", "calculate benefits", "calculate taxes", "benefit for a", "what would I get", "what is the maximum", "what is the rate", "income limit", "benefit amount", "maximum benefit", "compare provinces", "CCB", "Canada Child Benefit", "GST credit", "HST credit", "GST/HST", "OAS", "Old Age Security", "GIS", "Guaranteed Income Supplement", "CWB", "Canada Workers Benefit", "EI", "Employment Insurance", "CPP", "Canada Pension Plan", "RRSP", "TFSA", "Ontario Child Benefit", "OCB", "Ontario Trillium Benefit", "OTB", "BC Climate Action", "Alberta Child Benefit", "Quebec", "CRA", "Canada Revenue Agency", "Canadian", "Canada", "Ontario", "British Columbia", "Alberta", "Saskatchewan", "Manitoba", "Nova Scotia", "New Brunswick", "PEI", "Newfoundland", "Yukon", "NWT", "Nunavut", "provincial tax", "federal tax Canada".
policyengine-ui-kit-consumer
This skill should be used when setting up a new project that uses @policyengine/ui-kit, debugging CSS or styling issues in a consumer app, or when Tailwind utility classes are not being generated. Also use when creating globals.css, configuring PostCSS, or troubleshooting "no styles", "no spacing", or "no layout" problems. Triggers: "ui-kit import", "globals.css setup", "Tailwind not working", "styles not applying", "utility classes missing", "setup ui-kit", "PostCSS config", "no styling", "CSS broken", "import ui-kit", "theme.css", "no layout", "no spacing", "@tailwindcss/postcss"
policyengine-tailwind-shadcn
Tailwind CSS v4 + shadcn/ui integration patterns for PolicyEngine frontend projects. Covers @theme namespaces, CSS variable conventions, SVG var() usage, and common mistakes. Triggers: "Tailwind v4", "@theme", "shadcn", "CSS variables", "design tokens CSS", "theme.css", "@theme inline"
Didn't find tool you were looking for?