Agent Plugins 1.0 · Portable Agent Skill

Modern Java advice,
bounded by your JDK.

The java.evolved agent plugin detects the Java version your project actually targets, then recommends only the final language features, APIs, and practices that version supports.

version detector
$ detect_java_version.py .
source maven.compiler.release
target Java 21
preview disabled
✓ Guidance bounded to Java 21

It reads the contract, not just the machine.

An installed JDK does not prove what a project can compile. The detector prioritizes explicit build targets and keeps lower-confidence evidence visible.

Maven Gradle Toolchains Version files CI Runtime
Effective target with source, priority, and conflicts

Useful guardrails, built in.

Version-aware by default

Recommendations are cumulative through the detected release, from Java 8 through Java 25.

Preview stays opt-in

Preview and incubating features are never presented as production-ready defaults.

Made for real Java work

Use it for implementation, review, refactoring, upgrades, concurrency, testing, security, and API design.

Portable, vendor-neutral

The package follows the open Agent Plugins 1.0 and Agent Skills specifications.

How it works in a session.

  1. 1

    Detect

    The agent inspects the project or module's compilation target and reports conflicting configuration.

  2. 2

    Bound

    It loads core practices plus final capabilities from the target release and every earlier release.

  3. 3

    Recommend

    It writes, reviews, or modernizes code without silently raising your minimum Java version.

Try asking
“Review this service and suggest modern Java improvements without changing its Java 17 target.”

Install it in your agent.

Copilot CLI supports the complete Agent Plugins package. Claude Code and Codex CLI use the portable modern-java skill included in the package.

GitHub Copilot

Add the java.evolved marketplace once, then install the plugin.

copilot plugin marketplace add javaevolved/javaevolved.github.io
copilot plugin install modern-java-development@javaevolved
Copilot plugin documentation

Claude Code

Clone the repository, then install the skill for your user account.

git clone --depth 1 https://github.com/javaevolved/javaevolved.github.io.git
mkdir -p ~/.claude/skills && cp -R javaevolved.github.io/agent-plugins/modern-java-development/skills/modern-java ~/.claude/skills/

For one project, copy it to .claude/skills/modern-java instead.

Claude Code skill documentation

OpenAI Codex CLI

Clone the repository, then install the skill for your user account.

git clone --depth 1 https://github.com/javaevolved/javaevolved.github.io.git
mkdir -p ~/.agents/skills && cp -R javaevolved.github.io/agent-plugins/modern-java-development/skills/modern-java ~/.agents/skills/

For one project, copy it to .agents/skills/modern-java instead.

Codex skill documentation