Agent skill

Python project conventions

Project conventions for install, lint, test, format, and coverage via Make

Stars 96
Forks 5

Install this agent skill to your Project

npx add-skill https://github.com/rcarmo/agentbox/tree/main/skel/.github/skills/python

SKILL.md

Skill: Python project conventions

Goal

Provide a consistent Python dev experience (install/lint/test/format/coverage) via Make targets.

Expected repo files

  • pyproject.toml (preferred) or requirements*.txt
  • Package code under src/ (preferred) or top-level package dir
  • Tests under tests/

Make targets (recommended)

  • make installpython -m pip install -e .
  • make install-dev → install dev extras + ruff/pytest
  • make lintruff check ...
  • make formatruff format ...
  • make testpython -m pytest
  • make coveragepython -m pytest --cov=... --cov-report=term-missing
  • make checkmake lint && make coverage

Quality Bars

  • End product should be installable from the final repo URL via uv tool or pip

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results