# clean-code

> Claude/Codex skill by [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars · Updated 2026-10-16

This skill should be used when writing, reviewing, or refactoring code. Contains SRP, DRY, YAGNI, naming, error handling, dependency direction, and Kent Beck's four rules of simple design.

## Install

```sh
git clone https://github.com/incubyte/ai-plugins /tmp/ai-plugins && ln -s /tmp/ai-plugins/bee/skills/clean-code ~/.claude/skills/clean-code
```

## From README

Clean Code Principles These principles apply to ALL code Bee produces, evaluates, or cleans up — regardless of architecture pattern, language, or framework. They are non-negotiable defaults. The target project's CLAUDE.md may add project-specific conventions on top of these. YAGNI — You Aren't Gonna Need It Don't build what nothing asks for. Before writing any code, abstraction, or interface, ask: does a test or acceptance criterion require this RIGHT NOW? One implementation? Skip the interface. Extract the interface when a second implementation actually arrives. No test demands it? Don't build it. "Might need it someday" is not a reason. Unused parameters, empty extension points, commented-out feature flags — all YAGNI violations. Remove them. DRY — Don't Repeat Yourself Every piece of knowledge should have a single, authoritative representation. Extract on the third occurrence, not the second. Two similar blocks might be coincidence. Three means there's a pattern.

## Links

- HTML page: https://omgskills.com/library/incubyte/ai-plugins/bee/skills/clean-code/
- GitHub: https://github.com/incubyte/ai-plugins
- Author: [@incubyte](https://omgskills.com/library/incubyte/index.md)

## More from this repo

- [ai-ergonomics](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/ai-ergonomics/index.md) — This skill should be used when evaluating how well code supports LLM-assisted development.
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars
- [ai-workflow](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/ai-workflow/index.md) — This skill should be used when explaining why Bee follows spec-first TDD workflows, or when teaching mode is on.
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars
- [architecture-patterns](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/architecture-patterns/index.md) — This skill should be used when evaluating architecture options, checking dependency direction, or deciding between...
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars