python-project-structure
Guidelines for organizing Python projects with clear module boundaries, explicit public APIs, and clean structures.
Install
npx skills add https://github.com/wshobson/agents --skill python-project-structureStats
| Total installs | 3,922 |
| Weekly installs | 3.9K |
| GitHub stars | 32.4K |
| First seen | Jan 30, 2026 |
| Source | @wshobson/agents |
Summary
- Define public APIs with __all__ in every module; unlisted members remain internal implementation details
- Prefer flat directory structures with minimal nesting; add sub-packages only for genuine sub-domains
- Organize by architectural layers (API, services, repositories, models) or business domains depending on project complexity
- Keep files focused on a single concept; consider splitting when files exceed 300–500 lines or handle unrelated responsibilities
- Use absolute imports and consistent snake_case naming; match file names to their primary class or concept
Tags
Related skills
| Skill | Installs | vs python-project-structure |
|---|---|---|
| typescript-react-reviewer | 3,900 | -22 |
| mermaid-diagrams | 3,602 | -320 |
| clean-code | 4,151 | +229 |
| web-component-design | 4,579 | +657 |
| php-pro | 4,409 | +487 |
FAQ
- How many installs does python-project-structure have?
- python-project-structure has 3,922 total installs and 3.9K installs this week.
- Where is python-project-structure hosted?
- python-project-structure is published by @wshobson/agents at https://github.com/wshobson/agents.
- How many GitHub stars does python-project-structure have?
- python-project-structure has 32.4K GitHub stars.
- When was python-project-structure first indexed?
- OrangeBot.AI first indexed python-project-structure on Jan 30, 2026.
- How do I install python-project-structure?
- Run: npx skills add https://github.com/wshobson/agents --skill python-project-structure