solid
ramziddin/solid-skills · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por ramziddin/solid-skills no skills.sh. Instale com: npx skills add ramziddin/solid-skills@solid
Details
- Kind
- Agent skills
- Topic
- No topic detected
- Publisher
- ramziddin
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 585
- Forks
- 70
- Last push
- 2026-09-03T16:09:53Z
- Repository state
- ativo
- Added
- 2026-08-30 15:21:50
- Updated
- 2026-09-08 15:03:29
- Origin id
ramziddin/solid-skills/solid
README
# Solid Skills
Professional software engineering skills for AI coding agents. Transforms code into senior-engineer quality software through SOLID principles, TDD, clean code practices, and professional software design.
Skills follow the [Agent Skills](https://github.com/anthropics/skills) format.
## Available Skills
### solid
Transform junior-level code into senior-engineer quality software. Primarily designed for **TypeScript** and **NestJS** projects, but applicable to any object-oriented codebase.
**Use when:**
- Writing any code (features, fixes, utilities)
- Refactoring existing code
- Planning or designing architecture
- Reviewing code quality
- Debugging issues
- Creating tests
- Making design decisions
**Core principles:**
| Principle | Focus |
|-----------|-------|
| TDD | Red-Green-Refactor cycle, tests before code |
| SOLID | Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion |
| Clean Code | Meaningful names, small functions, no comments needed |
| Design Patterns | Creational, Structural, Behavioral patterns |
| Architecture | Vertical slicing, dependency rule, clean architecture |
**Reference documentation included:**
- `solid-principles.md` - SOLID principles with TypeScript examples
- `tdd.md` - Test-Driven Development practices
- `testing.md` - Testing strategies and patterns
- `clean-code.md` - Clean code guidelines
- `code-smells.md` - Code smell detection and fixes
- `design-patterns.md` - GoF patterns with examples
- `architecture.md` - Clean architecture principles
- `object-design.md` - Object stereotypes and responsibilities
- `complexity.md` - Managing essential vs accidental complexity
**Key features:**
- Enforces TDD workflow (write failing test first)
- Detects and fixes code smells automatically
- Applies SOLID principles to every class and function
- Uses value objects for domain primitives (IDs, emails, money)
- Follows Law of Demeter and Tell Don't Ask
- Keeps methods under 10 lines, classes under 50 lines
## Installation
```bash
npx skills add ramziddin/solid-skills
```
## Usage
Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
**Examples:**
- "Implement a user registration feature"
- "Refactor this service to follow SOLID principles"
- "Review this code for quality issues"
- "Add tests for this module"
- "Design the architecture for a payment system"
## Skill Structure
```
skills/
└── solid/
├── SKILL.md # Main skill instructions
└── references/ # Supporting documentation
├── solid-principles.md
├── tdd.md
├── testing.md
├── clean-code.md
├── code-smells.md
├── design-patterns.md
├── architecture.md
├── object-design.md
└── complexity.md
```
## Credits
- Clean code practices in `clean-code.md` include concepts from the **"Clean Code" course summary** by [Academind GmbH / Maximilian Schwarzmuller](https://academind.com) (c) 2020.
## License
MIT