Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ramziddin-solid-skills/badge.svg)](/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)

  1. # Solid Skills
  2. 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.
  3. Skills follow the [Agent Skills](https://github.com/anthropics/skills) format.
  4. ## Available Skills
  5. ### solid
  6. Transform junior-level code into senior-engineer quality software. Primarily designed for **TypeScript** and **NestJS** projects, but applicable to any object-oriented codebase.
  7. **Use when:**
  8. - Writing any code (features, fixes, utilities)
  9. - Refactoring existing code
  10. - Planning or designing architecture
  11. - Reviewing code quality
  12. - Debugging issues
  13. - Creating tests
  14. - Making design decisions
  15. **Core principles:**
  16. | Principle | Focus |
  17. |-----------|-------|
  18. | TDD | Red-Green-Refactor cycle, tests before code |
  19. | SOLID | Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion |
  20. | Clean Code | Meaningful names, small functions, no comments needed |
  21. | Design Patterns | Creational, Structural, Behavioral patterns |
  22. | Architecture | Vertical slicing, dependency rule, clean architecture |
  23. **Reference documentation included:**
  24. - `solid-principles.md` - SOLID principles with TypeScript examples
  25. - `tdd.md` - Test-Driven Development practices
  26. - `testing.md` - Testing strategies and patterns
  27. - `clean-code.md` - Clean code guidelines
  28. - `code-smells.md` - Code smell detection and fixes
  29. - `design-patterns.md` - GoF patterns with examples
  30. - `architecture.md` - Clean architecture principles
  31. - `object-design.md` - Object stereotypes and responsibilities
  32. - `complexity.md` - Managing essential vs accidental complexity
  33. **Key features:**
  34. - Enforces TDD workflow (write failing test first)
  35. - Detects and fixes code smells automatically
  36. - Applies SOLID principles to every class and function
  37. - Uses value objects for domain primitives (IDs, emails, money)
  38. - Follows Law of Demeter and Tell Don't Ask
  39. - Keeps methods under 10 lines, classes under 50 lines
  40. ## Installation
  41. ```bash
  42. npx skills add ramziddin/solid-skills
  43. ```
  44. ## Usage
  45. Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
  46. **Examples:**
  47. - "Implement a user registration feature"
  48. - "Refactor this service to follow SOLID principles"
  49. - "Review this code for quality issues"
  50. - "Add tests for this module"
  51. - "Design the architecture for a payment system"
  52. ## Skill Structure
  53. ```
  54. skills/
  55. └── solid/
  56. ├── SKILL.md # Main skill instructions
  57. └── references/ # Supporting documentation
  58. ├── solid-principles.md
  59. ├── tdd.md
  60. ├── testing.md
  61. ├── clean-code.md
  62. ├── code-smells.md
  63. ├── design-patterns.md
  64. ├── architecture.md
  65. ├── object-design.md
  66. └── complexity.md
  67. ```
  68. ## Credits
  69. - 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.
  70. ## License
  71. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.