python-project-scaffold

Generate a complete Python project scaffold with modern tooling and repository layout.

2|1|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/pytholic/claude-skills --skill python-project-scaffold-pytholic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-project-scaffold
Source: https://github.com/pytholic/claude-skills/tree/main/python-project-scaffold
Command: npx skills add https://github.com/pytholic/claude-skills --skill python-project-scaffold-pytholic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction and inconsistency of starting a new Python repository by generating a modern, opinionated project foundation in one pass.

Core Features & Use Cases

  • Project Triage: Distinguishes between libraries, applications, and lightweight scripts so the scaffold matches the actual use case.
  • Production-Ready Structure: Creates a complete repository layout with src-based packaging, tests, CI, linting, formatting, type checking, and contribution files.
  • Modern Python Tooling: Standardizes on uv, ruff, pyright, pytest, and pre-commit to establish a maintainable workflow from day one.
  • Human-Agent Context Setup: Integrates the HAC bootstrap process through the hac-init skill so project memory and task continuity are included.
  • Use Case: A developer can start a new internal Python service and immediately get a consistent repository skeleton with the right files, commands, and conventions.

Quick Start

Ask for a new Python project scaffold with the project name, type, dependencies, author details, and optional extras, and I will generate the full repository structure.

Frequently Asked Questions about python-project-scaffold

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

FAQPage Schema
How do I scaffold a new Python project with uv, ruff, and pyright?

Scaffold a new Python project by providing the project name, type, dependencies, and author details to generate a complete repository layout with uv, ruff, pyright, pytest, and pre-commit configurations.

What's the best way to set up a production-ready Python repository structure?

Set up a production-ready Python repository by generating an opinionated foundation with src-based packaging, tests, CI, linting, formatting, type checking, and contribution files in a single pass.

Can I use this Python project setup for both libraries and applications?

Yes, you can use this Python project setup for both libraries and applications. The triage process distinguishes between libraries, applications, and lightweight scripts to match the scaffold to your use case.

How does the scaffold handle contributor files and project conventions?

The scaffold handles contributor files and project conventions by bootstrapping repository conventions and integrating the HAC initialization process, ensuring project memory and task continuity are included from day one.

Do I need pyproject.toml to bootstrap a modern Python package layout?

Yes, you need pyproject.toml to bootstrap a modern Python package layout. The scaffold requires modern Python packaging conventions, standardizing on uv, ruff, pyright, pytest, and pre-commit.

Why use uv and ruff instead of other Python project setup tools?

Use uv and ruff for your Python project setup to establish a maintainable workflow from day one. This approach standardizes tooling and removes the friction and inconsistency of starting a new repository.