How do I install the Pyproject Config skill?

Run npx skillmds@latest add brojonat/pyproject-config in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pyproject Config safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pyproject Config?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pyproject Config free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pyproject Config?

brojonat (@brojonat) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pyproject Config by brojonat — Agent Skill

Name: Pyproject Config
Author: brojonat

File contents

pyproject.toml Configuration

Standard configuration for Python projects using setuptools, ruff, and pytest.

Console Scripts

[project.scripts]
my-tool = "your_package.cli:main"

Build System (src layout)

[build-system]
requires = ["setuptools>=68.0.0"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
package-dir = {"" = "src"}

[tool.setuptools.packages.find]
where = ["src"]

This enables uv pip install -e . for editable installs with a src/ layout.

Ruff

[tool.ruff]
target-version = "py313"
line-length = 100
src = ["src", "tests"]

[tool.ruff.lint]
select = ["E", "F", "I"]
ignore = ["E203", "W503"]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false

Pytest

[tool.pytest.ini_options]
python_files = ["test_*.py", "*_test.py", "*_tests.py"]

Project Layout

.
    pyproject.toml                  # project metadata, deps, tooling
    Makefile                        # common tasks (run, lint, test, build)
    .env.server                     # server env vars
    src/                            # application/CLI package (editable install)
        cli.py                      # Click CLI entrypoint
    server/                         # FastAPI app
        main.py                     # ASGI entrypoint
        templates/                  # Jinja2 templates
        static/                     # static assets
    data/                           # datasets and outputs
    plots/                          # generated figures

Keep a src/ layout for packages so editable installs work cleanly. Use .env.server and .env.client for local development with .env.example files alongside code.

---name: pyproject-configdescription: Configure Python projects with pyproject.toml including build system, console scripts, ruff linting, and pytest. Use when setting up a new Python project, configuring tooling, or adding entry points.---# pyproject.toml ConfigurationStandard configuration for Python projects using setuptools, ruff, and pytest.## Console Scripts```toml[project.scripts]my-tool = "your_package.cli:main"```## Build System (src layout)```toml[build-system]requires = ["setuptools>=68.0.0"]build-backend = "setuptools.build_meta"[tool.setuptools]package-dir = {"" = "src"}[tool.setuptools.packages.find]where = ["src"]```This enables `uv pip install -e .` for editable installs with a `src/` layout.## Ruff```toml[tool.ruff]target-version = "py313"line-length = 100src = ["src", "tests"][tool.ruff.lint]select = ["E", "F", "I"]ignore = ["E203", "W503"][tool.ruff.format]quote-style = "double"indent-style = "space"skip-magic-trailing-comma = false```## Pytest```toml[tool.pytest.ini_options]python_files = ["test_*.py", "*_test.py", "*_tests.py"]```## Project Layout```. pyproject.toml # project metadata, deps, tooling Makefile # common tasks (run, lint, test, build) .env.server # server env vars src/ # application/CLI package (editable install) cli.py # Click CLI entrypoint server/ # FastAPI app main.py # ASGI entrypoint templates/ # Jinja2 templates static/ # static assets data/ # datasets and outputs plots/ # generated figures```Keep a `src/` layout for packages so editable installs work cleanly. Use `.env.server` and `.env.client` for local development with `.env.example` files alongside code.

Frequently asked questions

Pyproject Config