Skip to content
Back to search

java-agent-skills

SkillWorks with Claude CodeGitHub

Agent Skills for Java development: code review, testing, architecture, Spring Boot, JPA, concurrency, security and release workflows.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/decebals--claude-code-java/badge.svg)](/listings/decebals--claude-code-java)

HTML

<a href="/listings/decebals--claude-code-java"><img src="/api/listings/decebals--claude-code-java/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Skills only

npx skills@latest add decebals/claude-code-java

No clone, no setup script. Add `--list` to see the skills first, `--skill <name>` to install only some of them, `--global` to install at user level instead of the current project, or `--copy` to get files instead of symlinks.

For the skills plus `CLAUDE.md` generation, MCP configuration and project settings, continue below.

1. Clone this workspace

git clone https://github.com/decebals/claude-code-java.git ~/projects/claude-code-java
cd ~/projects/claude-code-java
chmod +x scripts/*.sh

2. Setup your Java project

./scripts/setup-project.sh ~/projects/your-java-project

This creates `.claude/` with symlinked skills, generates `CLAUDE.md`, and configures settings.

**Prefer manual setup?** Just copy or symlink the skills you want:

mkdir -p your-project/.claude/skills

# Copy specific skills
cp -r ~/projects/claude-code-java/skills/java-code-review your-project/.claude/skills/

# Or symlink all skills
ln -s ~/projects/claude-code-java/skills/* your-project/.claude/skills/

3. Use with Claude Code

cd ~/projects/your-java-project
claude

# Skills load automatically based on context, or invoke directly:
> /git-commit
> /java-code-review

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  3. "name": "java-agent-skills",
  4. "version": "1.0.0",
  5. "description": "Agent Skills for Java development: code review, testing, architecture, Spring Boot, JPA, concurrency, security and release workflows.",
  6. "author": {
  7. "name": "Decebal Suiu",
  8. "url": "https://github.com/decebals"
  9. },
  10. "homepage": "https://github.com/decebals/claude-code-java",
  11. "repository": "https://github.com/decebals/claude-code-java",
  12. "license": "MIT",
  13. "keywords": ["agent-skills", "java", "maven", "spring-boot", "jpa", "code-review", "testing"]
  14. }
README.md · README · 221 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # claude-code-java
  2. > Agent Skills for Java projects, following the open Agent Skills specification
  3. [![Test](https://github.com/decebals/claude-code-java/actions/workflows/test.yml/badge.svg)](https://github.com/decebals/claude-code-java/actions/workflows/test.yml)
  4. [![Release](https://img.shields.io/github/v/release/decebals/claude-code-java)](https://github.com/decebals/claude-code-java/releases/latest)
  5. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-spec%20compliant-blue)](https://agentskills.io/specification)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. *This project is not affiliated with Anthropic.*
  8. ## What is this?
  9. A collection of reusable **skills** (structured markdown files that give an AI agent domain knowledge and workflows), plus project templates, MCP server configurations, and setup scripts.
  10. The skills follow the [Agent Skills specification](https://agentskills.io/specification), an open format read by a growing number of agents. They are developed and tested with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and every skill is validated against the spec in CI.
  11. **Who is this for?** Java developers who want consistent, high-quality AI assistance for common tasks like code reviews, testing, commits, and architecture decisions.
  12. ## Routing is tested
  13. An agent picks a skill from its name and description and nothing else. With eighteen of
  14. them the descriptions compete, and the failure is quiet: the wrong skill loads and answers
  15. plausibly anyway, so nobody notices.
  16. `scripts/eval-routing.sh` runs a set of prompts against the same list an agent receives and
  17. reports where one lands somewhere other than expected. It found a real defect the first
  18. time it ran: "this class does too much, split it" reached `clean-code` rather than
  19. `solid-principles`. Sharpening three descriptions took the set from 17 of 18 prompts routed
  20. correctly to 20 of 20.
  21. Every skill has at least one case, enforced by `scripts/validate-skills.sh` so the cases
  22. cannot fall behind the skills. The check runs against any OpenAI-compatible endpoint,
  23. including a local model. See [docs/SCRIPTS.md](docs/SCRIPTS.md#check-routing).
  24. ## Purpose
  25. AI-powered development workflows with focus on:
  26. - **Token efficiency** - Designed for fewer iterations and lower token usage
  27. - **Reproducible patterns** - Reusable workflows across projects
  28. - **Java ecosystem** - Tailored for Java/Maven development
  29. - **Incremental adoption** - Start small, expand as needed
  30. ## Quick Start
  31. ### Skills only
  32. ```bash
  33. npx skills@latest add decebals/claude-code-java
  34. ```
  35. No clone, no setup script. Add `--list` to see the skills first, `--skill <name>` to install
  36. only some of them, `--global` to install at user level instead of the current project, or
  37. `--copy` to get files instead of symlinks.
  38. For the skills plus `CLAUDE.md` generation, MCP configuration and project settings, continue
  39. below.
  40. ### 1. Clone this workspace
  41. ```bash
  42. git clone https://github.com/decebals/claude-code-java.git ~/projects/claude-code-java
  43. cd ~/projects/claude-code-java
  44. chmod +x scripts/*.sh
  45. ```
  46. ### 2. Setup your Java project
  47. ```bash
  48. ./scripts/setup-project.sh ~/projects/your-java-project
  49. ```
  50. This creates `.claude/` with symlinked skills, generates `CLAUDE.md`, and configures settings.
  51. **Prefer manual setup?** Just copy or symlink the skills you want:
  52. ```bash
  53. mkdir -p your-project/.claude/skills
  54. # Copy specific skills
  55. cp -r ~/projects/claude-code-java/skills/java-code-review your-project/.claude/skills/
  56. # Or symlink all skills
  57. ln -s ~/projects/claude-code-java/skills/* your-project/.claude/skills/
  58. ```
  59. ### 3. Use with Claude Code
  60. ```bash
  61. cd ~/projects/your-java-project
  62. claude
  63. # Skills load automatically based on context, or invoke directly:
  64. > /git-commit
  65. > /java-code-review
  66. ```
  67. ## Available Skills (18)
  68. Skills are automatically loaded by Claude Code based on context.
  69. ### Workflow
  70. | Skill | Trigger Examples |
  71. |-------|------------------|
  72. | [**git-commit**](skills/git-commit/) | "commit these changes", "create commit" |
  73. | [**changelog-generator**](skills/changelog-generator/) | "generate changelog", "what changed since release" |
  74. | [**issue-triage**](skills/issue-triage/) | "triage issues", "check open issues" |
  75. ### Code Quality
  76. | Skill | Trigger Examples |
  77. |-------|------------------|
  78. | [**java-code-review**](skills/java-code-review/) | "review this code", "check this PR" |
  79. | [**api-contract-review**](skills/api-contract-review/) | "review API", "check REST endpoints" |
  80. | [**concurrency-review**](skills/concurrency-review/) | "check thread safety", "review async code" |
  81. | [**performance-smell-detection**](skills/performance-smell-detection/) | "check performance", "find slow code" |
  82. | [**test-quality**](skills/test-quality/) | "add tests", "improve coverage" |
  83. | [**maven-dependency-audit**](skills/maven-dependency-audit/) | "check dependencies", "audit deps" |
  84. | [**security-audit**](skills/security-audit/) | "security review", "check OWASP", "vulnerabilities" |
  85. ### Architecture & Design
  86. | Skill | Trigger Examples |
  87. |-------|------------------|
  88. | [**architecture-review**](skills/architecture-review/) | "review architecture", "check package structure" |
  89. | [**solid-principles**](skills/solid-principles/) | "check SOLID", "single responsibility" |
  90. | [**design-patterns**](skills/design-patterns/) | "use factory pattern", "implement strategy" |
  91. | [**clean-code**](skills/clean-code/) | "clean this code", "refactor" |
  92. ### Framework & Data
  93. | Skill | Trigger Examples |
  94. |-------|------------------|
  95. | [**spring-boot-patterns**](skills/spring-boot-patterns/) | "create controller", "Spring Boot help" |
  96. | [**java-migration**](skills/java-migration/) | "upgrade to Java 21", "migrate from Java 8" |
  97. | [**jpa-patterns**](skills/jpa-patterns/) | "N+1 problem", "LazyInitializationException" |
  98. | [**logging-patterns**](skills/logging-patterns/) | "add logging", "debug this flow", "analyze logs" |
  99. See [skills/README.md](skills/README.md) for full documentation and [docs/SCRIPTS.md](docs/SCRIPTS.md) for setup script options.
  100. ## Project Structure
  101. ```
  102. claude-code-java/
  103. ├── README.md # This file
  104. ├── LICENSE # MIT license
  105. ├── .gitignore # Git ignore rules
  106. ├── .claude/
  107. │ └── skills/ # 18 reusable skills (see Available Skills above)
  108. ├── docs/ # Guidelines and best practices
  109. │ ├── DESIGN_PRINCIPLES.md # Core philosophy
  110. │ ├── RED_FLAGS.md # Warning signs to watch for
  111. │ ├── SAFE_WORKFLOWS.md # Step-by-step safe workflows
  112. │ ├── SCRIPTS.md # Scripts documentation
  113. │ ├── SKILL_GUIDELINES.md # How to create new skills
  114. │ └── TESTING.md # Testing strategy
  115. ├── templates/
  116. │ ├── CLAUDE.md.template # Template for projects
  117. │ ├── mcp-config.json.template # MCP configuration template
  118. │ ├── MCP_CONFIG.md.template # MCP documentation template
  119. │ └── settings.json.template # Claude Code settings (pre-approved commands)
  120. └── scripts/
  121. ├── setup-project.sh # Full project setup (orchestrator)
  122. ├── link-skills.sh # Symlink skills to project
  123. ├── generate-claude-md.sh # Generate CLAUDE.md
  124. ├── configure-mcp.sh # Configure MCP servers
  125. └── test-all.sh # Run all tests
  126. ```
  127. ## Typical Workflow
  128. 1. **Link skills** to your Java project
  129. 2. **Start Claude Code** in project directory
  130. 3. **Load skill** relevant to current task
  131. 4. **Execute workflow** with natural language
  132. 5. **Measure results** (tokens used, time saved)
  133. ## Success Metrics
  134. Track these to validate effectiveness:
  135. - **Token reduction**: Track your improvement vs manual workflows
  136. - **Time savings**: Measure before/after per task
  137. - **Reusability**: Number of projects using skills
  138. - **Quality**: Code review feedback, test coverage
  139. ## Requirements
  140. - An agent that reads Agent Skills. Developed and tested with the [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
  141. - Java 11+ projects (Java 17+ recommended)
  142. - Git for version control
  143. - Maven or Gradle build tool
  144. - (Optional) [GitHub MCP server](https://github.com/github/github-mcp-server) for issue management
  145. ## What's Included
  146. - 18 skills (workflow, code quality, architecture, frameworks)
  147. - Setup automation scripts
  148. - Project templates
  149. - Agent Skills spec compliance, enforced in CI by `scripts/validate-skills.sh` and the reference validator
  150. ## Used in automated code review
  151. These skills are not just for code generation — they are also used as the **single source of truth** for automated code review via [`skill-review`](https://github.com/decebals/skill-review), a reusable GitHub Actions workflow that evaluates pull requests against the same skills that Claude Code uses during development.
  152. Same skills. From generation to review. See [`skill-review-sandbox`](https://github.com/decebals/skill-review-sandbox) for a working example.
  153. ## Contributing
  154. Skills are evolving based on real-world usage. Try them, open issues, share what works.
  155. 1. Try the skills in your projects
  156. 2. Open issues for suggestions
  157. 3. Share token savings/improvements
  158. ## Documentation
  159. See [docs/](docs/) for detailed guides:
  160. - [DESIGN_PRINCIPLES.md](docs/DESIGN_PRINCIPLES.md) - Core philosophy
  161. - [SAFE_WORKFLOWS.md](docs/SAFE_WORKFLOWS.md) - Recommended workflows
  162. - [RED_FLAGS.md](docs/RED_FLAGS.md) - Warning signs to watch for
  163. - [SKILL_GUIDELINES.md](docs/SKILL_GUIDELINES.md) - How to create new skills
  164. - [RELEASING.md](docs/RELEASING.md) - Versioning and how a release is cut
  165. ## License
  166. MIT License - Use freely, modify as needed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.