CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/python-project-structure

Python project structure — pyproject.toml, src layout, __init__.py, .gitignore, dependency groups, type hints, py.typed, test structure, entry points, ruff/mypy configuration

91

1.03x
Quality

87%

Does it follow best practices?

Impact

99%

1.03x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

pyproject-toml.jsonverifiers/

{
  "instruction": "Use pyproject.toml with build-system, project metadata, and requires-python",
  "relevant_when": "Agent creates or scaffolds a Python project",
  "context": "Every new Python project must use pyproject.toml as the single source of project metadata and dependencies. It must include [build-system], [project] with name and version, and requires-python. Do not create setup.py or setup.cfg for new projects.",
  "sources": [
    {
      "type": "file",
      "filename": "skills/python-project-structure/SKILL.md",
      "tile": "tessl-labs/python-project-structure@0.2.0"
    }
  ],
  "checklist": [
    {
      "name": "pyproject-toml-exists",
      "rule": "A pyproject.toml file exists at the project root with [build-system] and [project] sections",
      "relevant_when": "Agent creates a Python project"
    },
    {
      "name": "requires-python",
      "rule": "pyproject.toml includes requires-python >= 3.11 (or higher)",
      "relevant_when": "Agent creates a pyproject.toml"
    },
    {
      "name": "no-setup-py",
      "rule": "No setup.py or setup.cfg is created for new projects — pyproject.toml is the only project configuration file",
      "relevant_when": "Agent creates a new Python project from scratch"
    }
  ]
}

tile.json