Self-hosted alternatives to python-project-structure

P

python-project-structure

Python project organization, module architecture, and public API design

python-project-structure is an agent skill from the wshobson/agents collection for organizing Python projects, their modules and their public interfaces. The aim is a layout where code is easy to find and changes are predictable. Its first core idea is module cohesion: group code that changes together, and give each module a single clear purpose. The skill covers defining a module's public API with __all__, so the parts meant for other code to use are explicit and everything else can change freely, and it helps decide between flat and nested directory structures as a project grows. It also covers where test files should live and how to organize a codebase that has become hard to navigate. The skill applies when starting a new Python project from scratch, reorganizing an existing codebase for clarity, defining public interfaces with __all__, choosing between flat and nested layouts, deciding how tests are placed, and creating reusable library packages. The layout advice fits both applications and libraries, and the right structure depends on the size and audience of the project, so the agent proposes a layout and the team confirms it. Reorganizing code moves files, so changes should be made in a separate commit and checked against the test suite. The skill is installed with the skills CLI from the wshobson/agents repository. Its skills.sh page showed about 14.4K installs and passing results from three security audits at the time of the scan.