python-project-setup

Generate uv-based Python scaffolds with src layout and PEP8 standards.

2|2|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/tasanakorn/cc-marketplace --skill python-project-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-project-setup
Source: https://github.com/tasanakorn/cc-marketplace/tree/main/plugins/python-dev/skills/python-project-setup
Command: npx skills add https://github.com/tasanakorn/cc-marketplace --skill python-project-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually setting up a new Python project or modernizing an existing one is often tedious, error-prone, and can lead to inconsistent standards. This Skill eliminates that complexity by automating the entire setup process, ensuring your projects adhere to modern best practices from day one.

Core Features & Use Cases

  • Modern Tooling: Automatically configures projects with uv for ultra-fast dependency management and virtual environments, replacing slower traditional tools.
  • Best Practices Enforcement: Ensures your project uses src layout, PEP8 standards, type hints, and a well-structured pyproject.toml for maintainability and scalability.
  • Interactive Setup: Guides you through selecting project types (CLI, TUI, pure library) and essential libraries, providing smart defaults to get you started quickly.
  • Use Case: Need to start a new Python CLI application? Instead of manually configuring pyproject.toml, venv, src structure, and adding click/rich, Claude handles it all in one go, leaving you to focus on your core application logic.

Quick Start

Ask Claude: "Create a new Python project for a CLI application."

Frequently Asked Questions about python-project-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new Python project with modern best practices?

Python project setup automates scaffolding with uv, src layout, PEP8 standards, and pyproject.toml configuration. Claude guides you through project type selection and dependency choices, generating a complete, production-ready structure in one step.

What is uv and why should I use it for Python projects?

uv is an ultra-fast Python package manager and virtual environment orchestrator that replaces traditional tools like pip and venv. It accelerates dependency resolution, environment creation, and editable installation while maintaining consistency across projects.

Can I automate Python project setup for CLI and TUI applications?

Yes. Project setup handles CLI, TUI, and pure library scaffolding with intelligent defaults. It configures appropriate tooling—click or rich for CLIs—automatically generates entry points, and applies src layout conventions tailored to your application type.

How do I modernize an existing Python project to follow current standards?

Apply project setup to your existing directory. It generates an updated pyproject.toml, configures tools like ruff and mypy, enforces src layout and PEP8 standards, and sets up uv-based virtual environment management without requiring manual rewrites.

What tools does project setup configure automatically?

Setup configures uv for environment and dependency management, generates pyproject.toml with metadata and dependencies, optionally integrates ruff for linting, mypy for type checking, and pytest for testing. All tools follow PEP8 and modern Python conventions.

Do I need to manually edit pyproject.toml after setup completes?

Project setup generates a complete, functional pyproject.toml with your project metadata, dependencies, and tool configurations. You can extend it for additional requirements, but the initial setup requires no manual edits to begin development.