Does this skill add Javadoc to every Java method?

No, this skill follows a strict clean code philosophy that discourages Javadoc on private methods and constructors, favoring self-documenting code and clear naming conventions instead.

Why does it favor composition over inheritance?

Composition is prioritized because it creates more flexible, decoupled code that is easier to test and modify compared to rigid inheritance hierarchies.

Can I use this for Spring Boot or other Java frameworks?

Absolutely. While the principles are core Java, they are highly applicable to modern frameworks like Spring Boot, Micronaut, and Quarkus to ensure backend logic remains clean and decoupled.

Does this skill help with code reviews?

Yes, it includes a comprehensive checklist to identify 'red flags' such as unnecessary inheritance, forced null parameters, and documentation of obvious getters and setters.

How does it handle software abstraction?

It takes a pragmatic approach, advising against the creation of interfaces or abstract classes until there is a clear need for polymorphism or multiple implementations exist.

Pragmatic Java Development

Name: Pragmatic Java Development
Author: mbarbieri

bymbarbieri

•

API開発

Applies SOLID principles and clean code practices to build maintainable, self-documenting Java applications with a focus on pragmatic abstraction.

The Pragmatic Java Development skill transforms Claude into a specialized Java architect focused on code quality and long-term maintainability. It enforces strict clean code standards, such as eliminating redundant Javadoc on private methods and favoring self-documenting code over excessive commenting. By prioritizing composition over inheritance and discouraging premature abstraction, this skill helps developers build lean, efficient Java systems that are easy to read and refactor. It is particularly useful for teams looking to standardize their Java practices around modern, pragmatic object-oriented design while avoiding common over-engineering pitfalls.

主な機能

01Enforces SOLID principles and clean object-oriented design patterns.

02Standardizes method design using clean overloads instead of null-parameter patterns.

03Promotes self-documenting code to eliminate noise from private method Javadoc.

04Prevents premature generalization by restricting interfaces to multi-implementation use cases.

052 GitHub stars

06Advocates for composition over inheritance to ensure flexible code reuse.

ユースケース

01Architecting new microservices with a focus on maintainability and clear public APIs.

02Refactoring legacy Java codebases to improve readability and architectural integrity.

03Conducting automated code reviews to identify redundant documentation and 'magic' values.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mbarbieri/my-claude java

For use in Claude.ai and ChatGPT