exception-hierarchies

Skills are documents that teach Claude to resist common bad patterns and produce higher quality code. Unlike tutorials, these skills:

• Resist pressure - Handle "just make it work" or "don't overcomplicate" requests
• Close loopholes - Address specific rationalizations Claude uses to violate principles
• Provide correct patterns - Show the right way, not just explain what's wrong

Each skill was developed using TDD for documentation: baseline tests reveal how Claude fails without the skill, then the skill is written to address those specific failures.

```bash

npx add-skill yanko-belov/code-craft

```

This installs skills to all supported agents (OpenCode, Claude Code, Codex, Cursor, etc.)

Options

```bash

# Install specific skills only

npx add-skill yanko-belov/code-craft -s single-responsibility yagni fail-fast

# Install globally (user-level)

npx add-skill yanko-belov/code-craft -g

# Install to specific agents

npx add-skill yanko-belov/code-craft -a opencode claude-code

# List available skills

npx add-skill yanko-belov/code-craft -l

# Install all skills to all agents without prompts

npx add-skill yanko-belov/code-craft --all

```

Supported Agents

• OpenCode
• Claude Code
• Codex
• Cursor
• Antigravity
• GitHub Copilot
• Roo Code

Manual Installation

```bash

# Clone and symlink

git clone https://github.com/yanko-belov/code-craft.git

cd code-craft

for skill in skills/*/; do

ln -sf "$(pwd)/$skill" ~/.claude/skills/

done

```

SOLID Principles

| Principle | Skill | Prevents |

|-----------|-------|----------|

| S | [Single Responsibility](./skills/single-responsibility/SKILL.md) | God classes, "just add it here" |

| O | [Open/Closed](./skills/open-closed/SKILL.md) | Adding if/else branches for new features |

| L | [Liskov Substitution](./skills/liskov-substitution/SKILL.md) | Override with throw/no-op |

| I | [Interface Segregation](./skills/interface-segregation/SKILL.md) | Fat interfaces, forced implementations |

| D | [Dependency Inversion](./skills/dependency-inversion/SKILL.md) | new Concrete() inside classes |

Core Principles

| Principle | Skill | Prevents |

|-----------|-------|----------|

| DRY | [Don't Repeat Yourself](./skills/dry/SKILL.md) | Copy-paste code, duplicated logic |

| YAGNI | [You Ain't Gonna Need It](./skills/yagni/SKILL.md) | Over-engineering, speculative features |

| KISS | [Keep It Simple](./skills/kiss/SKILL.md) | Clever one-liners, unnecessary complexity |

| Composition | [Composition over Inheritance](./skills/composition-over-inheritance/SKILL.md) | Deep inheritance hierarchies |

| Demeter | [Law of Demeter](./skills/law-of-demeter/SKILL.md) | a.b.c.d property chains |

| Fail Fast | [Fail Fast](./skills/fail-fast/SKILL.md) | Swallowed errors, silent failures |

Testing

| Skill | Prevents |

|-------|----------|

| [TDD](./skills/tdd/SKILL.md) | Tests as afterthought, untestable code |

| [Test Isolation](./skills/test-isolation/SKILL.md) | Flaky tests, shared state between tests |

| [AAA Pattern](./skills/aaa-pattern/SKILL.md) | Messy tests, unclear test structure |

Security

| Skill | Prevents |

|-------|----------|

| [Input Validation](./skills/input-validation/SKILL.md) | Injection attacks, invalid data |

| [Secrets Handling](./skills/secrets-handling/SKILL.md) | Hardcoded credentials, exposed secrets |

| [Auth Patterns](./skills/auth-patterns/SKILL.md) | Broken authentication, insecure sessions |

API Design

| Skill | Prevents |

|-------|----------|

| [REST Conventions](./skills/rest-conventions/SKILL.md) | Inconsistent endpoints, poor API design |

| [Error Responses](./skills/error-responses/SKILL.md) | Unhelpful errors, leaked internals |

| [Idempotency](./skills/idempotency/SKILL.md) | Duplicate opera