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

gitignore-python.jsonverifiers/

{
  "instruction": "Include .venv/, __pycache__/, dist/, and .env in .gitignore",
  "relevant_when": "Agent creates a Python project with a .gitignore file",
  "context": "Python projects must gitignore virtual environment directories (.venv/, venv/), bytecode (__pycache__/, *.pyc), build artifacts (dist/, *.egg-info/), and environment files (.env). Committing a virtual environment is a very common mistake that bloats the repository.",
  "sources": [
    {
      "type": "file",
      "filename": "skills/python-project-structure/SKILL.md",
      "tile": "tessl-labs/python-project-structure@0.2.0"
    }
  ],
  "checklist": [
    {
      "name": "venv-gitignored",
      "rule": ".gitignore includes .venv/ or venv/ to prevent committing the virtual environment directory",
      "relevant_when": "Agent creates a .gitignore for a Python project"
    },
    {
      "name": "pycache-gitignored",
      "rule": ".gitignore includes __pycache__/ to prevent committing Python bytecode cache",
      "relevant_when": "Agent creates a .gitignore for a Python project"
    },
    {
      "name": "dist-gitignored",
      "rule": ".gitignore includes dist/ and/or *.egg-info/ to prevent committing build artifacts",
      "relevant_when": "Agent creates a .gitignore for a Python project"
    },
    {
      "name": "env-file-gitignored",
      "rule": ".gitignore includes .env to prevent committing environment secrets",
      "relevant_when": "Agent creates a .gitignore for a Python project that uses environment variables"
    }
  ]
}

tile.json