convez.ai
Skill
juanunix

clean-code-kotlin-skill

juanunix/clean-code-kotlin-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

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-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

Ver o original no GitHub

Bom para

Relacionados