Agent skill
Java Best Practices
Core engineering principles inspired by Effective Java and Clean Code.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/best-practices-hoangnguyen0403-agent-skills-standar-2
Metadata
Additional technical details for this skill
- labels
-
java best-practices effective-java clean-code
- triggers
-
{ "files": [ "**/*.java" ], "keywords": [ "refactor", "clean code", "smells", "patterns", "design" ] }
SKILL.md
Java Best Practices
Priority: P1 (HIGH)
Core engineering principles for robust, maintainable Java systems.
Implementation Guidelines
- Immutability: Prefer immutable objects (
finalfields, unmodifiable collections). - Access Modifiers: Minimize visibility. Default to package-private (no modifier). Use
privatefor all fields. Onlypublicfor API contracts. - Composition > Inheritance: Favor
Has-AoverIs-A. Avoid deep hierarchies. - Constructors: Use Static Factory Methods (
User.of()) over complex constructors. - Builder Pattern: Use for objects with 4+ parameters.
- Exceptions: Use Checked vs Unchecked wisely. Recoverable -> Checked; Programming Error -> Unchecked.
- Fail Fast: Validate parameters (
Objects.requireNonNull) at the method start. - Interfaces: Code to interfaces (
List,Map), not implementations (ArrayList,HashMap). - Dependency Injection: Invert control. Inject dependencies via constructor.
- Method References: Use
String::toUpperCaseovers -> s.toUpperCase()where readable.
Anti-Patterns
- Return Null: Returns empty
Optionalor Collection instead. - Empty Catch: Never swallow exceptions. Log or rethrow.
- God Class: Single Responsibility Principle. Break it down.
- Magic Numbers: Extract constants with meaningful names.
- Mutable Statics: Avoid
public staticfields (Global state).
Code
// Static Factory + Builder (Implicit via Library or Manual)
public class Pizza {
private final int size;
private final boolean cheese;
private Pizza(Builder b) { ... }
public static Pizza of(int size) {
return new Pizza(size, false);
}
}
// Composition
public class Service {
private final Repository repo; // Injected
public Service(Repository repo) {
this.repo = Objects.requireNonNull(repo);
}
}
Related Topics
language | concurrency | tooling
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?