What is the best directory structure for a Python project?

This skill recommends a flat hierarchy for simple projects to minimize complexity and a 'src' layout for larger libraries to ensure clean packaging and distribution.

Where should I put my tests?

The skill helps you choose between colocated tests for immediate visibility or parallel test directories for a clean separation of production and verification code.

How does Claude help with Python refactoring?

Using this skill, Claude can analyze your codebase to identify over-sized files, suggest logical module splits, and apply consistent naming conventions across the project.

Does this skill support Domain-Driven Design (DDD)?

Yes, it includes advanced patterns for organizing complex applications by business domains rather than just technical layers like 'models' or 'views'.

Why should I use __all__ in my modules?

Defining __all__ explicitly communicates the public interface of a module to developers and tools, keeping internal implementation details private and imports clean.

Python Project Architect

Name: Python Project Architect
Author: wshobson

bywshobson

•

27,605

•

개발자 도구

Organizes Python codebases with clear module boundaries, explicit public APIs, and maintainable directory structures.

The Python Project Structure skill empowers Claude to design and implement scalable, professional-grade Python project architectures. It provides specific guidance on choosing between flat and nested directory layouts, defining clean public interfaces using __all__, and implementing advanced organizational patterns like Layered Architecture or Domain-Driven Design (DDD). Whether you are scaffolding a new library or refactoring a monolithic script, this skill ensures your code remains discoverable, maintainable, and aligned with modern Python packaging standards.

주요 기능

01Optimized package initialization and absolute import management

02Strategic test organization and placement strategies

03Implementation of Layered and Domain-Driven Design (DDD) patterns

04Explicit public API design using __all__ exports

05Standardized directory layout generation for libraries and apps

0627,605 GitHub stars

사용 사례

01Defining clean, predictable public interfaces for shared internal libraries

02Refactoring a monolithic codebase into a modular, decoupled architecture

03Scaffolding a production-ready Python package from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add wshobson/agents python-project-structure

For use in Claude.ai and ChatGPT

Download Skill