wshobson/agents

python-design-patterns

Python design patterns including KISS, Separation of Concerns, Single Responsibility, and composition over inheritance. Use this skill when designing a new service or component from scratch and choosing how to layer responsibilities, when refactoring a God class or monolithic function that has grown too large, when deciding whether to add a new abstraction or live with duplication, when evaluating a pull request for structural issues like tight coupling or leaking internal types, when choosing between inheritance and composition for a new class hierarchy, or when a codebase is becoming hard to test because of entangled I/O and business logic.

All-time #1172 Trending #3113 First seen Jan 30, 2026
8-week activity · all time api

Installation

$ npx skills add https://github.com/wshobson/agents
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • Fundamental design principles for writing maintainable, testable Python code.
  • Covers five core patterns: KISS (Keep It Simple), Single Responsibility Principle, Separation of Concerns, Composition Over Inheritance, and the Rule of Three Includes practical code examples contrasting anti-patterns with recommended approaches for each principle Provides layered architecture guidance (API, Service, Repository layers) with dependency injection patterns for testability Emphasizes explicit, readable code over premature abstraction and offers guidelines for function size and complexity management

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from wshobson/agents · top by installs.

npx skills add https://github.com/wshobson/agents

Browse all from wshobson/agents

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 39.5K
License LICENSE
Default branch main
Open issues 4
Status Active

History

  1. First seen on skills.sh
  2. First recorded snapshot · 20,123 installs