# Pyproject Toml

> Configure Python projects with pyproject.toml for modern packaging, tools, and dependency management

- Skill: `vamseeachanta/pyproject-toml` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/pyproject-toml`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/pyproject-toml/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/pyproject-toml

---


# Pyproject Toml

## When to Use This Skill

Use pyproject.toml configuration when you need:
- **Project metadata** - Name, version, description, authors
- **Dependency management** - Core and optional dependencies
- **Build configuration** - Setuptools, hatch, flit, or poetry
- **Tool configuration** - pytest, ruff, mypy, black, isort
- **Entry points** - CLI scripts and plugins
- **Package discovery** - Source directory configuration

**Avoid when:**
- Legacy projects requiring setup.py (rare, migrate instead)
- Non-Python projects

## Resources

- **PEP 517**: Build system interface
- **PEP 518**: pyproject.toml specification
- **PEP 621**: Project metadata
- **PEP 660**: Editable installs
- **Setuptools**: https://setuptools.pypa.io/
- **UV**: https://docs.astral.sh/uv/

---

**Use this template for all Python projects in workspace-hub!**

## Sub-Skills

- [1. Version Constraints (+3)](1-version-constraints/SKILL.md)

## Sub-Skills

- [Complete pyproject.toml Template](complete-pyprojecttoml-template/SKILL.md)
- [1. Build System (+4)](1-build-system/SKILL.md)
- [pytest (+2)](pytest/SKILL.md)
- [Example 1: Data Processing Library (+2)](example-1-data-processing-library/SKILL.md)