How do I install the Solid Python skill?

Run npx skillmds@latest add fusengine/solid-python in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Solid Python safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Solid Python?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Solid Python free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Solid Python?

fusengine (@fusengine) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Solid Python by fusengine — Agent Skill

Name: Solid Python
Rating: 4.5 (4 reviews)
Author: fusengine

File contents

Before writing any new code it requires a DRY check against core/services and core/interfaces. See principles.md for the 5 SOLID principles and patterns.md for directory layout, testing, and typing conventions.

SOLID Python - Modular Architecture

Agent Workflow (MANDATORY)

Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:

fuse-ai-pilot:explore-codebase - Analyze existing architecture
fuse-ai-pilot:research-expert - Verify Python docs via Context7
fuse-ai-pilot:sniper - Post-implementation validation

DRY - Reuse Before Creating (MANDATORY)

Before writing ANY new code:

Grep the codebase for similar interfaces, services, or logic
Check shared locations: core/services/, core/interfaces/
If similar code exists -> extend/reuse instead of duplicate
If code will be used by 2+ features -> create it in core/

Architecture (Modules MANDATORY)

Layer	Location	Max Lines
Routes	`modules/[feature]/routes/`	50
Services	`modules/[feature]/services/`	100
Repositories	`modules/[feature]/repositories/`	100
Interfaces	`modules/[feature]/interfaces/`	30
Models	`modules/[feature]/models/`	50
Shared	`core/{services,interfaces,models}/`	-

NEVER use flat src/ structure - always modules/[feature]/

Critical Rules (MANDATORY)

Rule	Value
File limit	100 lines (split at 90)
Routes	< 50 lines, delegate to services
Interfaces	`interfaces/` directory ONLY
Docstrings	Every public function documented
Type hints	MANDATORY on all signatures
Protocols	Use `typing.Protocol` for interfaces
Small interfaces	1-3 methods max

Reference Guide

Topic	Reference	When to consult
SOLID Principles	principles.md	Quick reference for all 5 principles
Patterns & Structure	patterns.md	Directory layout, testing, typing

Forbidden

Anti-Pattern	Fix
Files > 100 lines	Split at 90
Interfaces in impl files	Move to `interfaces/` directory
Fat interfaces (4+ methods)	Split into small Protocols
Flat `src/` structure	Use `modules/[feature]/`
Concrete dependencies	Use Protocol + dependency injection
Missing type hints	Add type annotations to all signatures

---name: solid-pythondescription: Use when writing or refactoring Python code, structuring modules/[feature]/ layers, or defining Protocol-based interfaces (SOLID, files < 100 lines).---<objective>SOLID Python enforces a modular architecture for Python 3.12+: every feature lives under `modules/[feature]/` (routes, services, repositories, interfaces, models) with shared code in `core/`, interfaces are defined with `typing.Protocol` and live only in `interfaces/` directories, type hints are mandatory on every signature, and every public function carries a docstring.Before writing any new code it requires a DRY check against `core/services` and `core/interfaces`. See `principles.md` for the 5 SOLID principles and `patterns.md` for directory layout, testing, and typing conventions.</objective># SOLID Python - Modular Architecture## Agent Workflow (MANDATORY)Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:1. **fuse-ai-pilot:explore-codebase** - Analyze existing architecture2. **fuse-ai-pilot:research-expert** - Verify Python docs via Context73. **fuse-ai-pilot:sniper** - Post-implementation validation---## DRY - Reuse Before Creating (MANDATORY)**Before writing ANY new code:**1. **Grep the codebase** for similar interfaces, services, or logic2. Check shared locations: `core/services/`, `core/interfaces/`3. If similar code exists -> extend/reuse instead of duplicate4. If code will be used by 2+ features -> create it in `core/`---## Architecture (Modules MANDATORY)| Layer | Location | Max Lines ||-------|----------|-----------|| Routes | `modules/[feature]/routes/` | 50 || Services | `modules/[feature]/services/` | 100 || Repositories | `modules/[feature]/repositories/` | 100 || Interfaces | `modules/[feature]/interfaces/` | 30 || Models | `modules/[feature]/models/` | 50 || Shared | `core/{services,interfaces,models}/` | - |**NEVER use flat `src/` structure - always `modules/[feature]/`**---## Critical Rules (MANDATORY)| Rule | Value ||------|-------|| File limit | 100 lines (split at 90) || Routes | < 50 lines, delegate to services || Interfaces | `interfaces/` directory ONLY || Docstrings | Every public function documented || Type hints | MANDATORY on all signatures || Protocols | Use `typing.Protocol` for interfaces || Small interfaces | 1-3 methods max |---## Reference Guide| Topic | Reference | When to consult ||-------|-----------|-----------------|| **SOLID Principles** | [principles.md](references/principles.md) | Quick reference for all 5 principles || **Patterns & Structure** | [patterns.md](references/patterns.md) | Directory layout, testing, typing |---## Forbidden| Anti-Pattern | Fix ||--------------|-----|| Files > 100 lines | Split at 90 || Interfaces in impl files | Move to `interfaces/` directory || Fat interfaces (4+ methods) | Split into small Protocols || Flat `src/` structure | Use `modules/[feature]/` || Concrete dependencies | Use Protocol + dependency injection || Missing type hints | Add type annotations to all signatures |

Frequently asked questions

Solid Python