Where should I place my test files using this skill?

The skill provides guidance on both colocated testing (tests next to code) and parallel test directories, helping you choose and implement the strategy that best fits your project size.

Can I use this to refactor an existing Python project?

Yes, the skill includes patterns for reorganizing large, complex files into focused modules and transitioning from flat structures to layered or domain-driven architectures.

How does this skill improve Python imports?

It enforces the use of absolute imports and explicit __all__ definitions in __init__.py files, making package structures more reliable and preventing circular dependency issues.

What is the Python Project Architect skill?

It is a specialized capability for Claude Code that provides domain-specific guidance on organizing Python directories, modules, and public API interfaces according to industry best practices.

Python Project Architect

Name: Python Project Architect
Author: gwickman

bygwickman

0•

Developer Tools

Architects clean, maintainable Python projects using industry-standard module organization and explicit API patterns.

Python Project Architect provides a comprehensive framework for organizing Python codebases, from initial directory layout to advanced domain-driven design. It helps developers establish clear module boundaries, define robust public interfaces using __all__, and implement consistent naming conventions across services, models, and repositories. Whether you are bootstrapping a new library or refactoring a monolithic application, this skill ensures your code remains discoverable, scalable, and follows Pythonic best practices for imports and package initialization.

Key Features

01Explicit public API definition using __all__ exports

020 GitHub stars

03Automated directory layout planning for flat and nested structures

04Guidance on layered and domain-driven architectural patterns

05Standardized module naming and absolute import enforcement

06Consistent test organization strategies including colocated and parallel layouts

Use Cases

01Refactoring a disorganized codebase into a modular layered architecture

02Bootstrapping a new Python library with a clean public interface

03Establishing consistent project conventions for a scaling development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gwickman/auto-dev-test-target-1 python-project-structure

For use in Claude.ai and ChatGPT

Download Skill