java-docs
π―Skillfrom github/awesome-copilot
Ensures Java types are documented with Javadoc comments following best practices, including summary descriptions, parameter tags, and proper formatting for public and protected members.
Overview
This skill ensures Java types are properly documented with Javadoc comments following established best practices. It covers documentation standards for public and protected members including summary descriptions, parameter tags, return values, exception documentation, cross-references, and proper formatting for inline code and code blocks.
Key Features
- Javadoc Standards - Enforces proper use of @param, @return, @throws, @see, @since, @version, @author, and @deprecated tags following Java documentation conventions
- Summary Description - Guides first-sentence summary writing as a concise overview ending with a period, which becomes the primary description in generated documentation
- Generic Type Documentation - Supports @param <T> for type parameters in generic types and methods, ensuring type-safe code is properly documented
- Code Formatting - Uses
{@code}for inline snippets and<pre>{@code ...}</pre>for code blocks to ensure proper rendering in Javadoc output - Inheritance Support - Applies
{@inheritDoc}for inherited documentation from base classes or interfaces unless behavior differs significantly
Who is this for?
Java developers who need to maintain consistent Javadoc documentation across their codebases. Ideal for library authors, API developers, and teams following code documentation standards where proper Javadoc comments are essential for generated API documentation and IDE developer experience.
Same repository
github/awesome-copilot(224 items)
Installation
npx vibeindex add github/awesome-copilot --skill java-docsnpx skills add github/awesome-copilot --skill java-docs~/.claude/skills/java-docs/SKILL.mdSKILL.md
More from this repository10
A community-curated collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot across different domains, languages, and use cases.
A community-curated collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot across different domains, languages, and use cases.
Generates comprehensive Product Requirements Documents (PRDs) by systematically analyzing requirements and crafting detailed technical specifications
A community-curated collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot across different domains, languages, and use cases.
Generates Excalidraw diagrams from natural language descriptions, creating visual representations of processes, systems, relationships, and ideas.
Expert technical writer guided by the Diataxis framework, creating tutorials, how-to guides, reference docs, and explanation pages for software documentation.
Automates browser interactions, debugging, and performance analysis using Chrome DevTools for comprehensive web page inspection and control.
Provides Spring Boot best practices covering project setup, dependency injection, REST API design, data access with JPA, security configuration, and testing strategies.
A community-curated collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot across different domains, languages, and use cases.
Manages GitHub Issues through the GitHub API, enabling creation, searching, labeling, and triaging of issues directly from the coding environment.