plugins/solid/skills/solid-python/SKILL.md
SOLID principles for Python 3.12+. Files < 100 lines, interfaces separated, modular architecture. Modules MANDATORY.
npx skillsauth add fusengine/agents solid-pythonInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Before ANY implementation, use TeamCreate to spawn 3 agents:
Before writing ANY new code:
core/services/, core/interfaces/core/| 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]/
| 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 |
| Topic | Reference | When to consult | |-------|-----------|-----------------| | SOLID Principles | principles.md | Quick reference for all 5 principles | | Patterns & Structure | patterns.md | Directory layout, testing, typing |
| 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 |
development
Use when optimizing entity-based / semantic SEO 2026. Covers entity maps, Google Knowledge Graph resolution, salience scoring, passage-level ranking, about/sameAs/knowsAbout schema, Cloud Natural Language API validation.
development
Use when running SEO, GEO, schema, Core Web Vitals, sitemap, hreflang, E-E-A-T, AI Overviews, technical SEO, or structured data tasks. Covers full-site audits, single-page analysis, schema markup, content quality, AI search optimization, local SEO, sitemap/robots, internal linking, semantic clustering, and search experience.
development
Use when optimizing search experience (SXO). Covers intent matching, user personas, user stories, page-type analysis, dwell time, scroll depth, pogo-sticking prevention.
development
Use when optimizing local SEO. Covers Google Business Profile, NAP consistency, citations, reviews acquisition, Local Pack ranking, location pages, LocalBusiness schema.