clean-code-kotlin-skill
juanunix/clean-code-kotlin-skill
A Claude Code skill adapting Robert C. Martin's Clean Code to idiomatic Kotlin, chapter by chapter, with a validated runnable example.
Instalação
npx convez-ai juanunix/clean-code-kotlin-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
clean-code-kotlin
A Claude Code skill that adapts Robert C. Martin's Clean Code: A Handbook of Agile Software Craftsmanship to idiomatic Kotlin — chapter by chapter, with realistic before/after examples and a complete, runnable worked example.
What's inside
clean-code-kotlin/
├── SKILL.md # skill index + master checklist
└── references/
├── 01-meaningful-names.md (book ch. 2)
├── 02-functions.md (ch. 3)
├── 03-comments.md (ch. 4)
├── 04-formatting.md (ch. 5)
├── 05-objects-and-data-structures.md (ch. 6)
├── 06-error-handling.md (ch. 7)
├── 07-boundaries.md (ch. 8)
├── 08-unit-tests.md (ch. 9)
├── 09-classes.md (ch. 10)
├── 10-systems.md (ch. 11)
├── 11-emergence-simple-design.md (ch. 12)
├── 12-concurrency.md (ch. 13)
├── 13-successive-refinement.md (ch. 14 — case study)
├── 15-junit-internals.md (ch. 15 — case study)
├── 16-refactoring-serialdate.md (ch. 16 — case study)
├── 14-smells-and-heuristics.md (ch. 17)
└── 00-worked-example/ # runnable Gradle + Kotlin project
Each reference file condenses the chapter's rules, shows ❌ before / ✅ after
Kotlin (coroutines, sealed classes, value class, Result, null-safety — not
Java-in-Kotlin), and ends with a review checklist.
The worked example
references/00-worked-example/ is a small but complete checkout domain
(domain / app / infra layers) that applies every chapter together:
value objects, sealed results, dependency injection, a decorator, a composition
root, F.I.R.S.T. tests, and an enforced ktlint + detekt quality gate.
It is validated end to end (Gradle 8.10.2, Kotlin 2.0.21, JDK 17):
cd references/00-worked-example
./gradlew run # runs the sample checkout
./gradlew test # 10/10 tests pass
./gradlew check # ktlint + detekt + test — BUILD SUCCESSFUL
Using it as a Claude Code skill
Clone (or copy) this repository into your Claude Code skills directory:
git clone https://github.com/<you>/clean-code-kotlin.git \
~/.claude/skills/clean-code-kotlin
The skill then activates when you ask Claude to write, review, or refactor
Kotlin following Clean Code, or invoke it explicitly with
/clean-code-kotlin.
Attribution
The principles and chapter structure come from Clean Code by Robert C. Martin (Prentice Hall, 2008). This repository contains original Kotlin code and explanations inspired by the book — not the book's text. Buy the book; it's worth it.
The example code in this repository is released under the MIT License.