Java docs

Skill ducpm2303/claude-java-plugins/plugins/java-core/skills/java-docs

Java developer toolkit for Claude Code — skills, agents, hooks, and coding standards for Java 8+ projects

Install

npx -y skills add ducpm2303/claude-java-plugins --skill java-docs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Generates Javadoc comments for Java classes and methods. Use when user asks to "add javadoc", "document this class", "write documentation", "add comments", "generate docs", or "document this method".

SKILL.md

2.1 KB, as published. Nobody here has run it

Generate Javadoc comments for the Java code I've selected or provided. Follow standard Javadoc conventions.

Rules for generating Javadoc

For classes and interfaces:

/**
 * [One sentence describing the class's responsibility.]
 *
 * [Optional: 1–2 sentences of additional context, design pattern used, or usage note.]
 *
 * @author [omit — do not add @author unless already present]
 * @since [omit unless the user specifies a version]
 */

For public and protected methods:

/**
 * [One sentence describing what this method does — use active voice, e.g., "Returns the user with the given ID."]
 *
 * [Optional: additional detail about behaviour, side effects, or constraints — only if non-obvious.]
 *
 * @param paramName [description of the parameter — what it represents, valid values, null-safety]
 * @return [description of the return value — what it contains, when it is empty/null]
 * @throws ExceptionType [condition that causes this exception to be thrown]
 */

For fields:

Only document non-obvious fields with /** brief description */
Do not document self-evident fields like private String name;

Quality rules

Do not restate the method signature in the description (e.g., avoid "This method takes a String and returns a String")
Use present tense active voice: "Returns...", "Creates...", "Validates..."
For @param: describe what the parameter represents, not just its type
For @return: describe the returned value's meaning, not just "the result"
For @throws: describe the condition, not just the exception name
Do not add @param for void methods with no parameters
Do not add @return for void methods

Output