policyengine-standards

Enforce PolicyEngine development standards and CI checks across repositories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, black, prettier, pytest, npm, gh.

What problem does it solves? Maintaining high code quality, ensuring consistent development practices, and passing continuous integration (CI) checks across a multi-repository ecosystem can be challenging. This Skill provides a comprehensive guide to PolicyEngine's development standards, streamlining your workflow and preventing common errors.

Core Features & Use Cases

  • Coding Standards: Guidelines for Python 3.13, uv run for commands, and Jupyter Book 2.0 for documentation.
  • Test-Driven Development (TDD): Promotes writing tests first to ensure accuracy, prevent regressions, and build confidence in refactoring.
  • Automated PR Workflow: Introduces the /create-pr command that automatically waits for CI to pass before marking a pull request as ready.
  • Common AI Pitfalls: Highlights frequent mistakes made by AI-generated code, such as file versioning and unformatted commits, to help you avoid them.
  • Use Case: Before submitting a pull request, use this skill to verify that your Python code is formatted with Black, all tests pass, and the PR description follows the standard, including referencing an issue.

Quick Start

Use the policyengine-standards skill to format all Python files in your current directory using Black.

Frequently Asked Questions about policyengine-standards

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

FAQPage Schema
How do I enforce code quality standards across Python and JavaScript projects?

Code quality standards enforce consistent formatting, testing, and CI checks across repositories. This Skill applies PolicyEngine's development standards—Python 3.13 with `uv run`, Black for formatting, Prettier for JavaScript, and pytest for testing—automatically before commits and during PR reviews to prevent CI failures.

What's the best way to format Python code with Black before committing?

Use Black through this Skill to format all Python files in your current directory. The Skill integrates with your git workflow, applying formatting standards automatically and ensuring consistent code style across your repository before you push changes.

How do I set up test-driven development with pytest and CI automation?

Test-driven development writes tests first to prevent regressions and build confidence in refactoring. This Skill promotes TDD practices with pytest, requires all tests to pass before marking PRs ready, and automates CI validation through the `/create-pr` command that waits for checks to complete.

Can I use this Skill when setting up a new repository?

Yes. This Skill applies during new repository setup, enforcing Python 3.13, `uv run` for commands, Jupyter Book 2.0 with MyST-NB for documentation, Black formatting, Prettier for JavaScript, and pytest testing from the start to maintain consistent standards.

What common mistakes does this address in AI-generated code?

AI-generated code often has file versioning issues and unformatted commits. This Skill standardizes AI-generated code by applying Black, Prettier, and test requirements, catching these pitfalls during PR review so they don't reach CI and cause delays.

Do I need specific dependencies like npm and gh for code quality checks?

Yes. This Skill requires uv, Black, Prettier, pytest, npm, and gh. These tools handle Python formatting, JavaScript formatting, testing, and GitHub PR automation. All dependencies must be available in your environment to enforce standards across the full workflow.