ramziddin/solid-skills

What it solves

It addresses the gap between junior-level code generation and senior-engineer quality software. It provides AI coding agents with the professional software engineering standards required to produce maintainable, scalable, and robust code, specifically focusing on object-oriented programming.

How it works

The project provides a set of "skills" (following the Anthropics skills format) that act as instructions and reference documentation for AI agents. These skills guide the agent to apply Test-Driven Development (TDD), SOLID principles, Clean Code practices, and professional design patterns. It includes detailed reference files on topics like code smells, architecture, and object design to ensure the agent follows strict constraints, such as keeping methods under 10 lines and classes under 50 lines.

Who it’s for

Developers using AI coding agents who want their generated code to adhere to professional software engineering standards, particularly those working with TypeScript and NestJS.

Highlights

• TDD Enforcement: Forces the agent to follow the Red-Green-Refactor cycle by writing failing tests first.
• SOLID Integration: Applies Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, and Dependency Inversion principles.
• Clean Code Standards: Enforces meaningful naming, small functions, and the use of value objects for domain primitives.
• Comprehensive Reference: Includes documentation on GoF design patterns, Clean Architecture, and the Law of Demeter.