Setup Skill

Purpose

Create and configure Python project structures following modern best practices.

Instructions

Create Directory Structure

mkdir -p src/package_name/{models,database,services,ui,utils} mkdir -p tests touch src/package_name/init.py touch src/package_name/main.py

Create pyproject.toml

[project] name = "project-name" version = "0.1.0" description = "Project description" requires-python = ">=3.11" dependencies = []

[project.scripts] app = "package_name.main:app"

[build-system] requires = ["hatchling"] build-backend = "hatchling.build"

Create .gitignore

pycache/ *.py[cod] .venv/ .env *.json !package.json .pytest_cache/ .coverage htmlcov/ dist/ build/ *.egg-info/

Create README.md

Project Name

Installation

uv sync

Usage

uv run app

Examples

Create a new todo app structure

mkdir -p retro_todo/{models,database,services,ui,utils}
mkdir -p tests
touch retro_todo/__init__.py
touch retro_todo/main.py

Best Practices

- Use src
 layout for packages that will be distributed

- Keep flat layout for internal tools

- Always include __init__.py
 files

- Create separate directories for different concerns

- Include proper configuration files from start