python-project-template

name	python-project-template
description	Generate standardized Python project structure with pyproject.toml, UV environment, pytest configuration, and workspace-hub compliance. Creates production-ready project scaffolding.
version	1.0.0
category	development
type	skill
trigger	manual
auto_execute	false
capabilities	["project_scaffolding","pyproject_generation","dependency_configuration","testing_setup","uv_environment"]
tools	["Write","Bash","Read"]
related_skills	["pytest-fixture-generator"]
requires	[]
tags	[]

Python Project Template

Quick Start

# Create new project
/python-project-template my-project

# Create with specific type
/python-project-template my-project --type library

# Create in specific directory
/python-project-template my-project --path /path/to/projects

When to Use

USE when:

• Starting a new Python project
• Adding a new repository to workspace-hub
• Standardizing an existing project
• Creating reusable modules

DON'T USE when:

• Project already has proper structure
• Non-Python projects
• One-off scripts (use scripts/ directory instead)

Prerequisites

• Python 3.9+
• UV package manager installed
• Git initialized in parent directory

Overview

Creates a complete Python project with:

1. pyproject.toml - Modern Python packaging configuration
2. UV environment - Fast dependency management
3. Test structure - pytest with fixtures and coverage
4. Source layout - Modular src/ organization
5. Documentation - README, AGENTS.md, .agent-os/
6. Quality tools - ruff, black, mypy configuration

Related Skills

• pytest-fixture-generator - Enhanced testing
• repo-readiness - Verify project setup
• agent-os-framework - Full product documentation

References

• Python Packaging Guide
• UV Documentation
• workspace-hub Standards

---

Version History

• 1.0.0 (2026-01-14): Initial release - standardized Python project generation with pyproject.toml, UV support, pytest configuration, and workspace-hub compliance

Sub-Skills

• Example 1: Create Basic Project (+2)