Back to search
solid-skills
SkillWorks with Claude CodeGitHub
AI agent skill for writing senior-engineer quality code through SOLID principles, TDD, and clean architecture
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/ramziddin-solid-skills)HTML
<a href="/listings/ramziddin-solid-skills"><img src="/api/listings/ramziddin-solid-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills add ramziddin/solid-skills
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 96 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.