How do I install the Pyproject Toml skill?

Run npx skillmds@latest add hugobatista/pyproject-toml 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 Toml safe to use?

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

Which AI agents work with Pyproject Toml?

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 Toml free to use?

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

Who published Pyproject Toml?

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

Pyproject Toml by hugobatista — Agent Skill

Name: Pyproject Toml
Rating: 4.2 (5 reviews)
Author: hugobatista

File contents

pyproject.toml (mandatory template)

Read config.toml from this directory. If it exists, use it for defaults. If not, ask the user for their author info and write it to config.toml (one-time setup — future runs are faster).

Ask the user to confirm the author. Do not try to parse the name and email, just show the string as-is and ask for confirmation or correction.

Read assets/pyproject.toml.tmpl. Replace AUTHOR_PLACEHOLDER with the confirmed author, replace projectname with your project name, and write it to the project root.

Set required-version in [tool.uv] to the latest stable uv release that's been available for > 30 days (check https://github.com/astral-sh/uv/releases) - but minimum 0.11.18
Add [[tool.uv.index]] with explicit = true to declare the package index explicitly. This documents the trust boundary and prevents accidental cross-resolution if multiple indexes are configured.
```
[[tool.uv.index]]
name = "pypi"
url = "https://pypi.org/simple"
explicit = true
```

Required sections — verify each exists after substitution

Read the written file back and confirm every section below is present. The .tmpl file is the authoritative source — do not skip, merge, or drop any section.

[project] (name, version, description, authors, requires-python, dependencies)
[project.scripts] (CLI entry point)
[build-system] (hatchling)
[tool.uv] (required-version, exclude-newer)
[[tool.uv.index]] (pypi with explicit = true)
[tool.hatch.build.targets.wheel] (packages = ["src/..."])
[dependency-groups] (lint, test, dev with include-group)
[tool.hatch.envs.default] (type = "virtual", path = ".venv")
[tool.hatch.envs.default.scripts] (lint, format, test, typecheck, validate, check, check-fast)
[tool.pytest.ini_options]
[tool.coverage.run] and [tool.coverage.report]
[tool.mypy]
[tool.ruff], [tool.ruff.lint], [tool.ruff.format]

---name: pyproject-tomldescription: Use when creating or modifying pyproject.toml configuration for Python projects. Covers hatchling build, uv dependency management, and tool configuration for pytest, coverage, mypy, and ruff.---## pyproject.toml (mandatory template)Read `config.toml` from this directory. If it exists, use it for defaults. If not, ask the user for their author info and write it to `config.toml` (one-time setup — future runs are faster).Ask the user to confirm the author. Do not try to parse the name and email, just show the string as-is and ask for confirmation or correction.Read `assets/pyproject.toml.tmpl`. Replace `AUTHOR_PLACEHOLDER` with the confirmed author, replace `projectname` with your project name, and write it to the project root.- Set `required-version` in `[tool.uv]` to the latest stable uv release that's been available for > 30 days (check https://github.com/astral-sh/uv/releases) - but minimum 0.11.18- Add `[[tool.uv.index]]` with `explicit = true` to declare the package index explicitly. This documents the trust boundary and prevents accidental cross-resolution if multiple indexes are configured. ```toml [[tool.uv.index]] name = "pypi" url = "https://pypi.org/simple" explicit = true ```### Required sections — verify each exists after substitutionRead the written file back and confirm every section below is present. The `.tmpl` file is the authoritative source — do not skip, merge, or drop any section.- `[project]` (name, version, description, authors, requires-python, dependencies)- `[project.scripts]` (CLI entry point)- `[build-system]` (hatchling)- `[tool.uv]` (required-version, exclude-newer)- `[[tool.uv.index]]` (pypi with explicit = true)- `[tool.hatch.build.targets.wheel]` (packages = ["src/..."])- `[dependency-groups]` (lint, test, dev with include-group)- `[tool.hatch.envs.default]` (type = "virtual", path = ".venv")- `[tool.hatch.envs.default.scripts]` (lint, format, test, typecheck, validate, check, check-fast)- `[tool.pytest.ini_options]`- `[tool.coverage.run]` and `[tool.coverage.report]`- `[tool.mypy]`- `[tool.ruff]`, `[tool.ruff.lint]`, `[tool.ruff.format]`

Frequently asked questions

Pyproject Toml