Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

effective-java

English | Español


English

An Agent Skills skill that turns any compatible AI coding agent into an expert Java architect, applying the principles from Effective Java by Joshua Bloch across all 90 items.

License Agent Skills Java

What it does

This skill operates in two modes:

  • Generation — when you ask to create, generate, or write Java code, the agent produces output that applies Effective Java principles by default.
  • Review — when you ask to review or check code, the agent scans for violations and returns a structured report with: what is wrong, why it is a bad practice, how to fix it, and a before/after example.

Framework conventions (Spring, Quarkus, Jakarta EE) always take precedence over Effective Java principles when the two conflict.

Supported agents

This skill follows the Agent Skills Open Standard and works with any compatible agent, including:

  • Claude Code
  • OpenAI Codex CLI
  • Gemini CLI
  • Cursor
  • OpenCode
  • GitHub Copilot (VS Code)
  • Goose (Block)
  • Amp (Sourcegraph)
  • JetBrains Junie
  • AWS Kiro

Installation

Clone or copy the effective-java/ directory into your agent's skills folder.

Claude Code

# From your project root or ~/.claude
git clone https://github.com/aaron-za-dev/effective-java .claude/skills/effective-java

Other agents — refer to your agent's documentation for the skills directory location. The skill directory is effective-java/ and follows the standard Agent Skills layout.

Knowledge coverage

Reference file Items
creating-destroying-objects.md 1–9
common-methods.md 10–14
classes-interfaces.md 15–25
generics.md 26–33
enums-annotations.md 34–41
lambdas-streams.md 42–48
methods.md 49–56
general-programming.md 57–68
exceptions.md 69–77
concurrency.md 78–84
serialization.md 85–90
modern-java-features.md Java 10–25
enterprise-best-practices.md Testing, Logging, Observability

License

Apache 2.0 — see LICENSE.


Español

Un skill del estándar Agent Skills que convierte a cualquier agente de IA compatible en un arquitecto Java experto, aplicando los principios de Effective Java de Joshua Bloch en sus 90 ítems.

Licencia Agent Skills Java

Qué hace

Este skill opera en dos modos:

  • Generación — cuando pides crear, generar o escribir código Java, el agente produce código que aplica los principios de Effective Java por defecto.
  • Review — cuando pides revisar o analizar código, el agente escanea violaciones y devuelve un reporte estructurado con: qué está mal, por qué es una mala práctica, cómo corregirlo, y un ejemplo antes/después.

Las convenciones de frameworks (Spring, Quarkus, Jakarta EE) siempre tienen prioridad sobre los principios de Effective Java cuando hay conflicto.

Agentes soportados

Este skill sigue el Agent Skills Open Standard y funciona con cualquier agente compatible, incluyendo:

  • Claude Code
  • OpenAI Codex CLI
  • Gemini CLI
  • Cursor
  • OpenCode
  • GitHub Copilot (VS Code)
  • Goose (Block)
  • Amp (Sourcegraph)
  • JetBrains Junie
  • AWS Kiro

Instalación

Clona o copia el directorio effective-java/ en la carpeta de skills de tu agente.

Claude Code

# Desde la raíz de tu proyecto o ~/.claude
git clone https://github.com/aaron-za-dev/effective-java .claude/skills/effective-java

Otros agentes — consulta la documentación de tu agente para conocer la ubicación de la carpeta de skills. El directorio del skill es effective-java/ y sigue el layout estándar de Agent Skills.

Cobertura de conocimiento

Archivo de referencia Ítems
creating-destroying-objects.md 1–9
common-methods.md 10–14
classes-interfaces.md 15–25
generics.md 26–33
enums-annotations.md 34–41
lambdas-streams.md 42–48
methods.md 49–56
general-programming.md 57–68
exceptions.md 69–77
concurrency.md 78–84
serialization.md 85–90
modern-java-features.md Java 10–25
enterprise-best-practices.md Testing, Logging, Observabilidad

Licencia

Apache 2.0 — ver LICENSE.

About

Agent Skills plugin for AI coding agents. Applies all 90 Effective Java principles (Joshua Bloch) to code generation and review. Compatible with Claude Code, Codex, Gemini CLI, Cursor, and 30+ tools.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors