Initial commit

skills/python-project-setup/SKILL.md

@@ -0,0 +1,76 @@
+# Python Project Setup Skill
+
+Set up new Python projects following modern best practices with uv, ruff, pytest, and proper project structure.
+
+## When to Use This Skill
+
+Use this skill when:
+- User requests to create a new Python project
+- User wants to initialize Python tooling in an existing directory
+- User mentions setting up a Python development environment
+- User asks about Python project structure or best practices
+
+## Core Capabilities
+
+1. **Project Initialization**
+   - Initialize projects with `uv init`
+   - Set up proper directory structure
+   - Configure Python version with pyenv
+
+2. **Dependency Management**
+   - Install and configure uv package manager
+   - Add essential dependencies (pytest, ruff, mypy, pydantic)
+   - Set up development vs runtime dependencies
+
+3. **Configuration Files**
+   - Create `pyproject.toml` with tool configurations
+   - Set up `.gitignore` for Python projects
+   - Configure VSCode settings for Python development
+   - Create `.python-version` for version management
+
+4. **Project Structure**
+   - Create `src/<project_name>/` for source code
+   - Set up `tests/` directory for test files
+   - Create `docs/` for documentation
+   - Set up `.vscode/` for editor configuration
+
+## Context Files
+
+This skill references the following context files in this directory:
+- `project-structure-template.md` - Standard directory layout
+- `pyproject-toml-template.md` - Configuration template
+- `vscode-settings-template.json` - Editor configuration
+- `gitignore-template.md` - Python gitignore patterns
+- `readme-template.md` - README structure
+
+## Key Tools and Commands
+
+```bash
+# Project initialization
+uv init <project-name>
+
+# Dependency management
+uv add pytest --dev
+uv add ruff --dev
+uv add mypy --dev
+uv add pydantic
+
+# Sync dependencies
+uv sync
+```
+
+## Expected Outcomes
+
+After using this skill, the user should have:
+- A fully initialized Python project with modern tooling
+- Proper project structure following best practices
+- All essential dependencies installed
+- Configuration files set up correctly
+- Version control initialized (git)
+- Documentation scaffolding in place
+
+## Integration with Other Skills
+
+- Works with `python-code-quality` skill for linting setup
+- Works with `python-testing` skill for test framework configuration
+- Complements the `python-project-setup` agent for full orchestration