Does this skill support both src and flat project layouts?

Yes, while it encourages the modern 'src/' layout for better packaging and testing isolation, it provides patterns adaptable to various project scales and requirements.

When should I split a Python file into multiple modules?

You should consider splitting a file when it handles multiple unrelated responsibilities, grows beyond 300-500 lines, or contains classes that change for different business reasons.

Why should I use __all__ in my Python modules?

Using __all__ explicitly defines the public interface of a module. This ensures that only intended classes and functions are exposed to consumers, keeping internal implementation details private and imports clean.

What is the benefit of a flat directory structure in Python?

Flat structures reduce import complexity and make codebase navigation more intuitive. Deeply nested hierarchies often lead to verbose absolute imports and difficult-to-track dependencies.

Python Project Architect

Name: Python Project Architect
Author: sla-te

bysla-te

0•

Developer Tools

Organizes Python codebases using professional module architecture, explicit public interfaces, and maintainable directory layouts.

Python Project Architect provides a comprehensive framework for designing and reorganizing Python projects to ensure long-term maintainability. It implements industry best practices such as module cohesion, flat directory hierarchies, and the explicit definition of public APIs using __all__. Whether you are bootstrapping a new library, refactoring a monolith into a layered architecture, or implementing domain-driven design, this skill helps establish clear boundaries and predictable patterns that make your code more discoverable and easier to test.

Key Features

01Configurable test organization strategies (colocated vs. parallel)

02Strict adherence to Pythonic naming conventions and absolute imports

030 GitHub stars

04Explicit public API management using __all__ exports

05Architectural patterns including Layered and Domain-Driven design

06Standardized directory layouts (src-layout) for professional packaging

Use Cases

01Bootstrapping a new Python library with a clean, consumable public interface

02Refactoring monolithic legacy files into cohesive, single-responsibility modules

03Organizing complex web applications into clear architectural layers or domains

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sla-te/copilot-converter python-project-structure

For use in Claude.ai and ChatGPT

Download Skill