skills.rest
sunLeee
sunLeeeCOMMUNITY
Explore all skills by this author →
GitHub

convention-folder-structure

Organize Python monorepo folder layouts with libs/{name}/src/{name}/__init__.py structure.

Updated Mar 19, 2026
Search Tags:#architecture#python#monorepo#folder-structure#project-organization
One-click install
npx skills add https://github.com/sunLeee/optimization --skill convention-folder-structure
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convention-folder-structure
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/quality/style/folder-structure
Command: npx skills add https://github.com/sunLeee/optimization --skill convention-folder-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes a standardized, scalable folder layout for Python monorepos and DS/Agent projects to reduce onboarding time and architectural drift.

Core Features & Use Cases

  • Provides explicit guidelines for monorepo, single-package, DS, and agent structures.
  • Enforces required footprint for new libraries (libs/{name}/src/{name}/init.py) and shared utilities (libs/utils/).
  • Guides project evolution with concrete examples and best practices for organizing libs, agents, apps, tests, and docs.

Quick Start

Apply the folder-structure conventions when adding new libraries or shared utilities to ensure libs/{name}/src/{name}/init.py and libs/utils/ are created as described.

Frequently Asked Questions about convention-folder-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to organize a Python monorepo folder structure?▼

A scalable Python monorepo folder structure organizes new libraries under libs/{name}/src/{name}/__init__.py and shared utilities under libs/utils/, reducing onboarding time and architectural drift.

How do I structure a scalable Python project layout for data science?▼

Scalable Python project layouts for data science guide where libs, apps, agents, tests, and docs live, ensuring standardized organization across DS projects and agent-based architectures.

Can I use this folder structure convention for agent-based architectures?▼

Yes, the folder structure convention applies to agent-based architectures by providing explicit guidelines for organizing agents, apps, and shared utilities within a standardized monorepo layout.

Where should shared utilities live in a Python monorepo?▼

Shared utilities in a Python monorepo should live under the libs/utils/ directory, following the standardized footprint to ensure consistent project organization and reduce architectural drift.

Do I need to follow specific rules when adding new libraries to a monorepo?▼

When adding new libraries to a monorepo, you must create the required footprint of libs/{name}/src/{name}/__init__.py to enforce standardized folder layouts and maintain structural consistency.

Why does my Python project layout suffer from architectural drift?▼

Python project layouts suffer from architectural drift when lacking standardized folder structure conventions, resulting in inconsistent placement of libraries, utilities, tests, and documentation across the monorepo.

Related Skills

Explore More Software Engineering Skills→
pohlai88pohlai88

pnpm-workspace

Define pnpm-workspace.yaml and link local packages with the workspace protocol.

Community
Intermediate
vecearvecear

quality-gates-enforcer

Enforce coverage, linting, type checking, and security thresholds in CI pipelines.

Community
Advanced
WtydWtyd
9

docs

Organize GitHooks documentation pages with MkDocs and GitHub Actions deployment.

Community
Intermediate
jambolojambolo

advent-of-code

Scaffold Advent of Code repositories and verify solutions across languages.

Community
Advanced