Use this agent when writing, reviewing, refactoring, or maintaining Python code that requires production-grade quality, comprehensive testing, and adherence to engineering best practices. Specifically invoke this agent when: <example> Context: User has just implemented a new feature in Python and wants to ensure it meets quality standards. user: "I've written a new payment processing module with async handlers. Can you review it?" assistant: "I'll use the python-engineering-expert agent to conduct a thorough review of your payment processing module, checking code quality, test coverage, documentation sync, and adherence to engineering principles." <Task tool invocation for python-engineering-expert> </example> <example> Context: User is starting a new Python project and needs guidance on structure and tooling. user: "I need to create a new Python service for data ingestion from multiple APIs" assistant: "Let me engage the python-engineering-expert agent to help architect this service with proper project structure, tooling setup, and best practices from the start." <Task tool invocation for python-engineering-expert> </example> <example> Context: User has completed a logical unit of work and the agent proactively suggests review. user: "Here's the implementation for the user authentication handlers" assistant: "Great! Now let me use the python-engineering-expert agent to review this authentication code for security, testing, and adherence to our engineering principles." <Task tool invocation for python-engineering-expert> </example> <example> Context: Proactive engagement when user mentions testing or quality concerns. user: "I'm worried about the test coverage in our caching layer" assistant: "I'll invoke the python-engineering-expert agent to analyze the caching layer's test coverage and recommend improvements using pytest, pytest-cov, and our testing best practices." <Task tool invocation for python-engineering-expert> </example>
Use this agent when writing, reviewing, refactoring, or maintaining Python code in projects managed with uv. This agent ensures production-grade quality, comprehensive testing, and adherence to engineering best practices using uv as the project and dependency manager. <example> Context: User has just implemented a new feature in Python and wants to ensure it meets quality standards. user: "I've written a new payment processing module with async handlers. Can you review it?" assistant: "I'll use the uv-python-craftsperson agent to conduct a thorough review of your payment processing module, checking code quality, test coverage, documentation sync, and adherence to engineering principles." <Task tool invocation for uv-python-craftsperson> </example> <example> Context: User is starting a new Python project and needs guidance on structure and tooling. user: "I need to create a new Python service for data ingestion from multiple APIs" assistant: "Let me engage the uv-python-craftsperson agent to help architect this service with proper uv project structure, tooling setup, and best practices from the start." <Task tool invocation for uv-python-craftsperson> </example> <example> Context: User has completed a logical unit of work and the agent proactively suggests review. user: "Here's the implementation for the user authentication handlers" assistant: "Great! Now let me use the uv-python-craftsperson agent to review this authentication code for security, testing, and adherence to our engineering principles." <Task tool invocation for uv-python-craftsperson> </example> <example> Context: Proactive engagement when user mentions testing or quality concerns. user: "I'm worried about the test coverage in our caching layer" assistant: "I'll invoke the uv-python-craftsperson agent to analyze the caching layer's test coverage and recommend improvements using pytest, pytest-cov, and our testing best practices." <Task tool invocation for uv-python-craftsperson> </example>
Python dependency management with pip and venv. Use this skill when working in a Python project that uses pip, requirements.txt, setup.py, or pyproject.toml without uv.lock. Also use when the user mentions pip, venv, virtualenv, or asks about Python dependency management in a traditional pip-managed project. Provides dependency management patterns and quality gate commands for pip workflows.
Python project management with uv — the fast, Rust-based package and project manager. Use this skill when working in a Python project that has uv.lock, .python-version, or when pyproject.toml uses [tool.uv] or [dependency-groups]. Also use when the user mentions uv, "uv run", "uv add", or asks about Python dependency management in a uv-managed project. Provides project setup, dependency management, running tools, and quality gate commands specific to uv workflows.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Guardrails for AI-assisted software development — a collection of agents, skills, and quality guidance that keep agentic coding tools productive and consistent.
agents/ — Opinionated "craftsperson" agents for 16 language/framework stacks. Each agent enforces quality gates, TDD workflow, and language-idiomatic patterns. See agents/README.md.skills/ — Reusable skills following the Agent Skills specification. See skills/README.md.AGENTS.md — Baseline standards (versioning, frontmatter, file conventions) shared by all agents and skills in this repo.AI coding agents are powerful but unconstrained — they'll happily skip tests, ignore linters, invent abstractions nobody asked for, and commit without running quality checks. These guidelines give agents a clear set of engineering principles to follow:
Copy or symlink the agents and skills you need into your project's agentic tool configuration. Each agent is a standalone .md file; each skill is a self-contained directory with a SKILL.md.
For details on creating your own agents, see agents/MAKERS.md.
Stacey Vetzal — [email protected]
npx claudepluginhub svetzal/guidelines --plugin python-ecosystemClojure craftsperson agent
Go craftsperson agent
Stacey Vetzal's writing and presentation voice guides
Elixir and Phoenix craftsperson agents
Swift craftsperson agent for iOS, macOS, and server-side Swift
Opinionated Python 3.11+ engineering system. Establishes strong defaults (SOLID, typing policy, testing standards, code smell detection) and routes to specialist skills for TDD, CLI, web, data/science, and constrained environments.
Python-specific validation, patterns, and expert agents
Python development ecosystem - uv, ruff, pytest, packaging, type checking
Skills for packaging, releasing, and distributing Python libraries
Modern Python development suite - testing, performance optimization, async patterns, and packaging
Research-backed best practices for building modern, production-grade Python packages — project structure, pyproject.toml, typing, testing, CI/CD, documentation, versioning, API design, packaging, security, and developer experience