# solid

Enforces TDD workflows, SOLID design, and strict clean code constraints across coding tasks. Useful when designing architecture or refactoring messy codebases.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3500 installs · ★ 615
- Author: ramziddin
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ramziddin/solid-skills/tree/HEAD/skills/solid/SKILL.md
- Updated: 2026-09-03
- HTML: https://affpapa.org/en/nevibecode/skills/solid

## What it does

The skill directs your coding agent through a strict test-driven development workflow: write a failing test, create the simplest passing implementation, then refactor. Production code cannot be written without a corresponding failing test. Every function and class is evaluated against all five SOLID principles.

It introduces rigid Object Calisthenics rules. The agent wraps raw primitives like IDs, emails, and money amounts into dedicated value objects, avoids `else` blocks, limits methods to under 10 lines, and keeps classes below 50 lines. This level of discipline noticeably increases the class count and initial boilerplate.

For architecture, the skill mandates vertical slices and inward dependencies where external infrastructure depends on the core domain layer. During reviews, it spots architectural smells such as feature envy, shotgun surgery, and bloated parameter lists.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ramziddin/solid-skills --skill solid -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/solid/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/solid/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ramziddin/solid-skills --skill solid -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/solid/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ramziddin/solid-skills --skill solid -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/solid/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ramziddin/solid-skills solid
```

2. **Manually: put the files in place**
- File: `.github/skills/solid/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ramziddin/solid-skills --skill solid -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ramziddin/solid-skills --path skills/solid
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/solid/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ramziddin/solid-skills --skill solid -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ramziddin/solid-skills/tree/HEAD/skills/solid/SKILL.md

## When to use it
- refactor legacy classes into single-responsibility components
- enforce test-driven development with the Red-Green-Refactor loop
- replace bare primitive types with domain value objects
- detect code smells and excessive coupling during code review

## Example prompts
- Implement the checkout workflow using TDD and SOLID principles
- Refactor this controller to remove nested conditionals and wrap primitive values
- Review this pull request for SOLID violations and code smells

## Similar
- [solid-principles](https://affpapa.org/en/nevibecode/skills/solid-principles.md) — skill · 554 installs
- [typescript-clean-code](https://affpapa.org/en/nevibecode/skills/typescript-clean-code.md) — skill · 628 installs
- [clean-code-guard](https://affpapa.org/en/nevibecode/skills/clean-code-guard.md) — skill · 4700 installs
- [clean-code-principles](https://affpapa.org/en/nevibecode/skills/clean-code-principles.md) — skill · 1800 installs
- [code-refactoring-refactor-clean](https://affpapa.org/en/nevibecode/skills/code-refactoring-refactor-clean.md) — skill · 1200 installs
- [design-patterns-implementation](https://affpapa.org/en/nevibecode/skills/design-patterns-implementation.md) — skill · 595 installs

## Other versions with the same name
- [solid · vercel-labs](https://affpapa.org/en/nevibecode/skills/vercel-labs-solid.md) — 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md