JantonioFC Python Project Skeleton Generator
Creates production-ready Python project structures following modern best practices.
Quick Start
Generate a project in the current directory:
Project name: my-awesome-project
The skill prompts for required info and generates a complete project structure.
Configuration Options
| Option | Default | Description |
|---|---|---|
| Project name | (required) | Kebab-case name (e.g., my-project) |
| Package name | (derived) | Snake_case from project name |
| Python version | 3.14 | Minimum Python version |
| License | MIT | License type |
| Author name | (optional) | For pyproject.toml |
| Author email | (optional) | For pyproject.toml |
| Description | (optional) | Project description |
| Output mode | cwd | cwd, path, or tarball |
Generated Structure
{project-name}/
├── pyproject.toml # Full config with all tools
├── README.md
├── LICENSE
├── Makefile # UV-based dev targets
├── src/{package_name}/
│ ├── __init__.py # With __version__ = "0.1.0"
│ ├── py.typed # PEP 561 marker
│ └── main.py # Entry point stub
└── tests/
├── __init__.py
├── conftest.py # pytest fixtures
└── test_main.py # Example test
Included Tool Configurations
pyproject.toml sections:
[build-system]- Hatchling backend[project]- Dynamic version, classifiers, URLs[project.optional-dependencies]- dev group[dependency-groups]- UV compatibility[tool.hatch.version]- Points to__init__.py[tool.ruff]- Format + lint (E, W, F, I, B, C4, UP, ARG, SIM)[tool.mypy]- Strict configuration[tool.pytest]- Native TOML (pytest 9.0+)[tool.coverage]- 80% threshold[tool.bandit]- Security scanning
Makefile targets:
help- Categorized target listinstall,install-dev- UV-based installationtest,test-cov,coverage- Testing variantslint,typecheck,security- Quality toolsformat,format-check- Ruff formattingquality- All checks combinedbuild,clean- Package building
Output Modes
- cwd (default) - Create project in current working directory
- path - Create at specified absolute or relative path
- tarball - Create
.tar.gzarchive (useful for distribution)
Usage
Run the generator script:
python scripts/generate_project.py \
--name my-project \
--python-version 3.14 \
--output-mode cwd
Or invoke interactively - the skill will prompt for required values.
Post-Generation Steps
After generation:
cd {project-name}
uv sync # Install dependencies
make test # Run tests
make quality # Run all quality checks
Customization
The generated project is a starting point. Common modifications:
- Add dependencies to
[project.dependencies] - Adjust tool configs in pyproject.toml
- Add additional test files
- Extend Makefile with project-specific targets
When to Use
Generate production-ready Python project skeletons with Astral UV package manager, Hatchling build backend with dynamic versioning, and modern tooling (ruff, mypy, pytest, bandit).
Covers: Python Project Skeleton Generator, Configuration Options, Generated Structure, Included Tool Configurations, Output Modes.