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"

Stars 26
Forks 5

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:

bash
# 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:

yaml
---
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:

  1. Note the filename in this skill if it's a key proof point
  2. Update the "Key Posts to Reference" table above
  3. Consider if it warrants mention in related skills (e.g., country skills)

Resources

Expand your agent's capabilities with these related and highly-rated skills.

PolicyEngine/policyengine-claude

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".

26 5
Explore
PolicyEngine/policyengine-claude

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".

26 5
Explore
PolicyEngine/policyengine-claude

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".

26 5
Explore
PolicyEngine/policyengine-claude

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".

26 5
Explore
PolicyEngine/policyengine-claude

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"

26 5
Explore
PolicyEngine/policyengine-claude

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"

26 5
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results