java-conventions
Skill10 starsChanged 4 months agoMITView on GitHub
Versioned Java coding conventions for writing, generating, or reviewing Java code. Use when the user asks about Java style, Java conventions, idiomatic Java, modern Java, Java 25, or when writing/reviewing Java code where context-specific skills do not already cover style. Triggers on "Java conventions", "Java style", "Java code style", "modern Java", "Java 25", "idiomatic Java", or any request to write or review Java code. Composes with framework- and architecture-specific skills; when a composed skill specifies a rule, that rule wins.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- zapek/Xerestheir own version, first seen Oct 8, 2026
- preplant/skillstheir own version, first seen Sep 12, 2026
- techmefr/mentistheir own version, first seen Sep 11, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- zapek/Xeres★ 223same name
- preplant/skills★ 1same name
- techmefr/mentis★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- conventional-commitSkill
- diagramsSkill
- drawioSkill
- java-distillerSkill
- mermaidSkill
- microprofile-serverSkill
- migrate-to-bceSkill
- quarkus-jnosqlSkill
- sdd4j-bceSkill
- sdd4j-ears-testsSkill
- sdd4j-hexagonalSkill
- sdd4j-package-by-featureSkill
- sdd4j-package-by-layerSkill
- sdd4jSkill
- slddSkill
- spring-boot-serverSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Use the version the user explicitly mentions.
- Distinctive: line 15
Default to 25 if no version is found.
- Distinctive: line 18
If a composed skill has a specific rule for the same topic, the composed skill wins.
- Distinctive: line 29
Not build, packaging, framework, protocol, or architecture rules.
- Distinctive: line 30
When a composed skill specifies a rule, the composed skill wins.
- Distinctive: line 36
When a composed skill adds or refines a rule, apply it on top of these rules.
- Distinctive: line 37
If a composed skill is silent on a topic covered here, these rules apply by default.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Java Conventions
Enforce versioned, idiomatic Java language conventions. This skill is the fallback baseline for syntax, style, naming, visibility, structure, methods, streams, exceptions, and comments. Build, packaging, framework, protocol, and architecture rules come from composed skills (e.g., java-cli-script, java-cli-app, microprofile-server, spring-boot-server, sdd4j-bce, migrate-to-bce).
How to Use This Skill
- Determine the target Java version:
- Use the version the user explicitly mentions.
- Otherwise, read the version from the project (
pom.xml,build.gradle,module-info.java,README.md,system.properties). - Default to 25 if no version is found.
- Load the matching reference file from
references/java-<version>.md. - Apply the loaded conventions as the fallback baseline.
- If a composed skill has a specific rule for the same topic, the composed skill wins.
Bundled References
- Java 25 — references/java-25.md
When a reference for the requested version does not yet exist, fall back to the highest bundled reference that is not newer than the target, and only use features available in the target version. If the target is higher than all bundled references, use the newest bundled reference and note that it may not cover the latest features.
Scope
- Language-level rules only: syntax, style, naming, visibility, structure, methods, streams, exceptions, comments.
- Not build, packaging, framework, protocol, or architecture rules.
- When a composed skill specifies a rule, the composed skill wins; this skill is the fallback baseline.
Composition
- This skill defines only language-level Java conventions.
- Build, packaging, file layout, frameworks, protocols, and architecture come from the composed skill.
- When a composed skill adds or refines a rule, apply it on top of these rules; the composed skill always specializes, never contradicts.
- If a composed skill is silent on a topic covered here, these rules apply by default.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.