What problem does it solve? Python codebases often grow into tangled collections of files with unclear boundaries, hidden dependencies, and ambiguous public interfaces. This Skill provides concrete patterns for organizing modules, defining explicit public APIs, and structuring directories so code stays discoverable and maintainable as projects scale. ## Core Features & Use Cases - Module Architecture Patterns: Apply one-concept-per-file organization, flat directory structures, and layered or domain-driven layouts for services, models, and repositories. - Explicit Public Interfaces: Define what consumers can import using __all__ in __init__.py files, keeping internal helpers private by omission. - Test Organization Strategies: Choose between colocated tests and parallel test directories with consistent conventions. - Use Case: When starting a new FastAPI service, use this Skill to lay out api/, services/, repositories/, and models/ layers with clean package initialization so teammates can import from myapp import UserService without knowing internal file structure. ## Quick Start Ask the AI to design a directory structure and public API layout for a new Python project using the python-project-structure skill.
