Cursor-rules-java 170-java-documentation

Use when you need to generate or improve Java project documentation — including README.md files, package-info.java files, and Javadoc enhancements — through a modular, step-based interactive process that adapts to your specific documentation needs. Part of the skills-for-java project

install

source · Clone the upstream repo

git clone https://github.com/jabrena/cursor-rules-java

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jabrena/cursor-rules-java "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/170-java-documentation" ~/.claude/skills/jabrena-cursor-rules-java-170-java-documentation && rm -rf "$T"

manifest: skills/170-java-documentation/SKILL.md

Java Documentation Generator with modular step-based configuration

Generate comprehensive Java project documentation through a modular, step-based interactive process that covers README.md, package-info.java, and Javadoc. This is an interactive SKILL.

What is covered in this Skill?

README.md generation for single-module and multi-module Maven projects
package-info.java creation with basic/detailed/minimal documentation levels
Javadoc enhancement: comprehensive
```
@param
```
/
```
@return
```
/
```
@throws
```
tags
File handling strategies: overwrite/add/backup/skip

Final documentation validation with

./mvnw clean compile

and

./mvnw javadoc:javadoc

Constraints

Before applying any documentation generation, ensure the project validates. If validation fails, stop immediately — do not proceed until all validation errors are resolved.

MANDATORY: Run
```
./mvnw validate
```
or
```
mvn validate
```
before applying any documentation generation
SAFETY: If validation fails, stop immediately — do not proceed until all validation errors are resolved
BEFORE APPLYING: Read the reference for detailed good/bad examples, constraints, and safeguards for each documentation generation pattern

When to use this skill

Improve the code with documentation
Apply documentation
Refactor the code with documentation

Reference

For detailed guidance, examples, and constraints, see references/170-java-documentation.md.