python

Standardize Python project layouts with uv and msgspec data models.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Alpha-Innovation-Labs/opennexus --skill python-alpha-innovation-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python
Source: https://github.com/Alpha-Innovation-Labs/opennexus/tree/main/.nexus/ai_harness/rules/python
Command: npx skills add https://github.com/Alpha-Innovation-Labs/opennexus --skill python-alpha-innovation-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages and standardizes Python project layouts to ensure consistent environment, entry points, and data modeling practices across the codebase. A single, predictable structure reduces onboarding time and prevents ad-hoc configurations.

Core Features & Use Cases

  • Enforces uv as the centralized tool for environment, dependency, and run management.
  • Requires all runnable entry points to be declared in pyproject.toml under [project.scripts].
  • Promotes a src/ layout to keep implementation code isolated and organized.
  • Standardizes data models by using msgspec.Struct for lightweight, fast, type-safe models.
  • Minimizes relative imports and promotes explicit module boundaries.

Quick Start

Organize a Python project under src/, configure uv for runs, and declare entry points in pyproject.toml.

Frequently Asked Questions about python

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

FAQPage Schema
How do I standardize Python project structure with uv and src layout?

Standardize a Python project structure by configuring uv for environment management, enforcing a src/ layout for code, and declaring entry points in pyproject.toml. This ensures consistent project organization across teams.

What is the best way to manage Python entry points and dependencies with uv?

The best way to manage Python entry points with uv is to declare all runnable scripts under [project.scripts] in pyproject.toml. Use uv as the centralized tool for dependency and run management.

How do I configure msgspec for type-safe data models in a Python project?

Configure msgspec for type-safe data models by using msgspec.Struct for lightweight and fast structured data. This standardizes data modeling practices across the codebase, ensuring consistent type validation.

Why should I use src layout over relative imports in Python projects?

Using the src/ layout over relative imports ensures implementation code stays isolated and organized. It minimizes relative imports, promotes explicit module boundaries, and prevents top-level code outside src/.

Does uv work with pyproject.toml for Python environment management?

Yes, uv works directly with pyproject.toml to centralize Python environment, dependency, and run management. It requires all runnable entry points to be declared in the file for predictable execution.