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, CLAUDE.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)
• Best Practices

Sub-Skills

• Execution Checklist
• Error Handling

Sub-Skills

• Project Structure Generated
• 1. pyproject.toml (+2)
• Project Overview
• Critical Rules
• File Organization
• Key Commands
• 4. Core Module Template
• With repo-readiness (+1)