solid-principles
Skill0 starsChanged 4 days agoMITView on GitHub
Aplica y revisa los principios SOLID (SRP, OCP, LSP, ISP, DIP) a nivel de clase, módulo y componente, en backend y frontend: detecta violaciones, refactoriza con tests y decide cuándo NO aplicarlos. Úsala al diseñar o revisar clases, servicios, hooks o componentes con demasiadas responsabilidades o acoplamiento.
- Reads credentials
13 other projects use a version of this.
Adopted by
Most recently taken up by
- tayyebi/skillstheir own version, first seen Nov 15, 2026
- TheBeardedBearSAS/claude-crafttheir own version, first seen Nov 11, 2026
- decebals/claude-code-javatheir own version, first seen Nov 1, 2026
- Khuirul-Huda/clean-principlestheir own version, first seen Oct 25, 2026
- andr-ca/agentharnesstheir own version, first seen Oct 15, 2026
- nek1987/auto-agent-harnesstheir own version, first seen Oct 11, 2026
Other versions13 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 13
- decebals/claude-code-java★ 763same name
- TheBeardedBearSAS/claude-craft★ 108same name
- JeremyMorgan/code-review-skills★ 15same name
- robconery/kolea★ 7same name
- KhaledSaeed18/dotclaude★ 5same name
- nek1987/auto-agent-harness★ 4same name
- kayaman/skills★ 3same name
- kimtth/agent-skill-100-lines-or-less★ 2same name
- lucsedirae/agent_skill_library★ 2same name
- andr-ca/agentharness★ 1same name
3 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- git-cleanupSkill
- skill-creatorSkill
- astro-architectureSkill
- monorepo-architectureSkill
- nestjs-architectureSkill
- nextjs-architectureSkill
- react-native-architectureSkill
- gh-cliSkill
- git-cleanupSkill
- backend-best-practicesSkill
- clean-codeSkill
- code-quality-reviewSkill
- design-patternsSkill
- frontend-best-practicesSkill
- tdd-workflowSkill
- ssh-connectSkill
- ts-import-organizerSkill
- idd-applySkill
- idd-exploreSkill
- idd-planSkill
The file
Files
SOLID Principles
🎯 Propósito
Aplicar SOLID como herramienta de diagnóstico y de decisión, no como ritual. Cada principio responde a un dolor concreto (cambios que se propagan, tests imposibles, extensiones que obligan a editar código existente). Si ese dolor no existe, aplicar el principio solo añade capas.
Esta skill opera a nivel de clase, módulo y componente. Para legibilidad dentro de una función usa clean-code; para elegir un patrón concreto (Strategy, Adapter, Repository…) usa design-patterns; para la estructura de carpetas del proyecto, las skills de arquitectura.
⚡ Cuándo Activar esta Skill
- El usuario menciona SOLID o uno de sus principios, o pide "aplicar principios de diseño".
- Una clase, servicio, hook o componente "hace demasiado", es difícil de testear o cambia por motivos no relacionados.
- Añadir una variante (otro método de pago, otro proveedor, otro tipo de usuario) obliga a editar un
if/switchen varios sitios. - Se revisa código nuevo con dependencias creadas dentro de la clase (
new Stripe(),fetchdirecto en la lógica de negocio).
📋 Flujo de Trabajo Paso a Paso
1. Delimitar y leer
Identifica el alcance (un archivo, un módulo, un componente). Lee el código y sus tests, y las convenciones del proyecto: cómo inyecta dependencias, si usa contenedor DI (NestJS, Angular, tsyringe) o composición manual, estilo funcional o de clases. Las convenciones del proyecto ganan: en React o en código funcional, los principios se expresan con funciones, hooks y composición, no con jerarquías de clases.
2. Diagnosticar por señales, no por etiquetas
Recorre la tabla y anota solo lo que encuentres con evidencia concreta (archivo:línea).
| Principio | Señal de violación | Pregunta de diagnóstico |
| SRP | Descripción con "y" (valida Y guarda Y envía email); imports de capas distintas (HTTP, SQL, SDK de terceros); el archivo cambia por motivos ajenos entre sí | ¿Cuántas razones (actores o decisiones) tienen para cambiar esta unidad? |
| OCP | switch/if sobre un tipo repetido en varios sitios; añadir una variante obliga a editar código estable | ¿Puedo añadir un caso nuevo sin tocar lo existente? |
| LSP | Subclase que lanza NotImplemented, que ignora un método o que endurece precondiciones; instanceof en el código cliente | ¿Funciona el cliente igual con cualquier implementación? |
| ISP | Interfaz o props con muchos miembros de los que cada cliente usa pocos; mocks enormes en tests; métodos que lanzan "no soportado" | ¿Depende cada cliente solo de lo que usa? |
| DIP | new de infraestructura dentro de la lógica de negocio; el dominio importa del ORM, del SDK o de process.env | ¿La regla de negocio puede probarse sin red ni BD? |
Detalles, ejemplos de backend y frontend y refactors por principio: SRP, OCP, LSP, ISP, DIP.
3. Decidir si merece la pena (obligatorio)
Para cada violación, antes de tocar nada, responde:
- ¿Duele hoy? ¿Cambios que se propagan, bugs repetidos, tests imposibles, conflictos de merge constantes? Si no, y no hay una segunda variante a la vista, no apliques el principio; anótalo como observación.
- ¿Cuántas variantes reales hay? Una sola implementación no justifica una interfaz. Con dos, considera abstraer; con tres, abstrae (regla de tres).
- ¿Cuál es la solución más simple? Muchas veces basta extraer una función o mover un parámetro; una jerarquía de clases es el último recurso.
- ¿Qué coste añade? Más archivos, más indirección, más cosas que leer. Debe pagar por sí mismo.
Resume la decisión: Aplicar, Aplazar (esperar a la segunda variante) o No aplicar (con la razón).
4. Red de seguridad
Un refactor de diseño cambia la estructura, no el comportamiento. Ejecuta los tests existentes y anota el estado de partida. Si no cubren el código afectado, escribe tests de caracterización antes (si la skill tdd-workflow está disponible, sigue su Flujo C). Sin tests, limita el cambio a movimientos mecánicos y avisa del riesgo.
5. Refactorizar en pasos pequeños
- Un principio y una violación cada vez; tests entre pasos.
- Empieza por el cambio que más aísla: normalmente extraer una dependencia detrás de una interfaz pequeña (DIP + ISP) o extraer una responsabilidad (SRP).
- Mantén la API pública (exports, firmas, rutas, props) salvo que el usuario lo pida; si un cambio la rompe, avísalo antes.
- Las interfaces las define el consumidor y con lo que necesita, no copiando la API de la implementación.
- La composición se concentra en un punto (la raíz de la aplicación, el módulo de DI, el proveedor de contexto), no se reparte por el código.
6. Verificar y reportar
Ejecuta tests, typecheck y lint si el proyecto los tiene. Reporta con el formato de la sección "Reporte" e incluye también las decisiones de No aplicar y Aplazar: son parte del valor de la revisión.
🚫 Cuándo NO aplicar SOLID
- Una sola implementación sin razón para variar:
interface PaymentGatewaycon una única claseStripeGatewayy sin segundo proveedor en el horizonte es ruido, salvo que la interfaz sea la costura necesaria para testear. - Scripts, prototipos y código de usar y tirar.
- Funciones puras pequeñas: ya cumplen SRP y DIP por construcción.
- Cuando el framework ya impone la forma (un controlador de Nest, una página de Next): no luches contra la convención para satisfacer un principio.
- Para reducir líneas: SOLID suele aumentar el número de archivos; si el único objetivo es "menos código", usa
clean-code.
⚠️ Reglas Críticas
- No añadas abstracciones sin una razón concreta (variación real, costura de test o un dolor demostrable). Cita la razón en el reporte.
- Refactorizar no cambia el comportamiento. Sin tests que lo respalden, no lo afirmes; ejecuta los tests antes y después e informa del resultado real.
- No cambies la API pública sin avisar y sin confirmación.
- No fuerces jerarquías de clases en código funcional (React, hooks, módulos de funciones): usa composición y funciones.
- No instales dependencias (contenedores DI, librerías) sin confirmación; la inyección por constructor o por parámetro basta casi siempre.
- No toques lo que no se pidió: lo demás va a "Fuera de alcance".
- Los principios se justifican por su efecto, no por su nombre. "Esto viola SRP" no es un hallazgo; "este archivo cambia por tres motivos distintos, ver commits X e Y" sí lo es.
📤 Reporte
### Resumen
<1–2 frases: estado del diseño y las 1–3 violaciones de más impacto>
### Diagnóstico
| Principio | Ubicación | Evidencia | ¿Duele hoy? | Decisión |
|---|---|---|---|---|
| SRP | src/orders/order.service.ts:12-90 | Valida, calcula impuestos, persiste y envía email; cambió por 3 motivos en 3 commits | Sí | Aplicar |
| DIP | src/orders/order.service.ts:8 | `new SmtpMailer()` dentro del servicio; el test envía correos reales | Sí | Aplicar |
| OCP | src/pricing.ts:30 | `switch (tier)` solo en un sitio, 3 casos estables | No | No aplicar |
### Cambios aplicados
1. <refactor> — tests: ✅ N/N
### Aplazado / fuera de alcance
- <qué esperar a que exista una segunda variante, bugs vistos, decisiones para el usuario>📚 Referencias
- SRP: responsabilidad única
- OCP: abierto/cerrado
- LSP: sustitución de Liskov
- ISP: segregación de interfaces
- DIP: inversión de dependencias
- Ejemplo completo: servicio de pedidos
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

