python-new-project

Generate a new Python project structure using uv and src-layout.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/TriNgo0108/z-command --skill python-new-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-new-project
Source: https://github.com/TriNgo0108/z-command/tree/main/templates/skills/python-new-project
Command: npx skills add https://github.com/TriNgo0108/z-command --skill python-new-project

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill streamlines the creation of new Python projects by setting up a modern directory structure and essential tooling, reducing boilerplate and configuration time.

Core Features & Use Cases

  • Project Initialization: Creates a new Python project with a src layout.
  • Dependency Management: Integrates uv for efficient package management and virtual environment setup.
  • Use Case: Quickly start a new Python library or application with best practices for packaging and testing already in place.

Quick Start

Initialize a new Python project named 'my_awesome_project' using uv.

Frequently Asked Questions about python-new-project

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

FAQPage Schema
How do I set up a new Python project using uv and src-layout?

Setting up a new Python project with uv and src-layout involves generating a directory structure that isolates source code in a src folder. This method integrates uv for efficient package management and virtual environment synchronization.

What is the src-layout structure for Python packaging?

The src-layout structure for Python packaging places your actual importable package inside a src directory rather than the project root. This prevents accidental imports from the working directory and ensures tests run against the installed package.

Do I need uv installed before initializing a Python project?

Yes, uv must be installed and configured before initializing your Python project. The project setup requires uv specifically for initializing the project structure and synchronizing dependencies.

What's the best way to bootstrap a modern Python library with best practices?

The best way to bootstrap a modern Python library is to use a project initialization tool that generates a src-layout directory with uv for dependency management. This ensures best practices for packaging and testing are configured from the start.

Can I use uv for managing dependencies in a Python application?

Yes, uv can be used for managing dependencies in a Python application. The setup integrates uv to provide efficient package management and automate the virtual environment configuration for your application.

Why use uv instead of standard Python venv for project setup?

Using uv instead of standard Python venv streamlines project setup by integrating efficient package management and virtual environment synchronization directly into the initialization process. It reduces boilerplate and configuration time for modern Python projects.