Development
Plugin
claude-code-java
Reusable AI development infrastructure for Java projects, optimized for Claude Code This project is not affiliated with Anthropic.
Plugin Signal56/100Fair
maintained25
capable61
documented100
adopted61
Install
$ npx -y skills add decebals/claude-code-java --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
Skills
18/api-contract-reviewReview REST API contracts for HTTP semantics, versioning, backward compatibility, and response consistency. Use when user asks "review API", "check endpoints", "REST review", or before releasing API changes./architecture-reviewAnalyze Java project architecture at macro level - package structure, module boundaries, dependency direction, and layering. Use when user asks "review architecture", "check structure", "package organization", or when evaluating if a codebase follows clean architecture/changelog-generatorGenerate changelogs from git commits. Use when user says "generate changelog", "update changelog", "what changed since last release", or before preparing a new release./clean-codeClean Code principles (DRY, KISS, YAGNI), naming conventions, function design, and refactoring. Use when user says "clean this code", "refactor", "improve readability", or when reviewing code quality./concurrency-reviewReview Java concurrency code for thread safety, race conditions, deadlocks, and modern patterns (Virtual Threads, CompletableFuture, @Async). Use when user asks "check thread safety", "concurrency review", "async code review", or when reviewing multi-threaded code./design-patternsCommon design patterns with Java examples (Factory, Builder, Strategy, Observer, Decorator, etc.). Use when user asks "implement pattern", "use factory", "strategy pattern", or when designing extensible components.
Show all 18 skillsShow fewer
/git-commitGenerate conventional commit messages for Java projects. Use when user says "commit", "create commit", "commit changes", or after completing code changes that need to be committed./issue-triageTriage and categorize GitHub issues with priority labels. Use when user says "triage issues", "check issues", "review open issues", or during regular maintenance of GitHub issue backlog./java-code-reviewSystematic code review for Java with null safety, exception handling, concurrency, and performance checks. Use when user says "review code", "check this PR", "code review", or before merging changes./java-migrationGuide for upgrading Java projects between major versions (8→11→17→21→25). Use when user says "upgrade Java", "migrate to Java 25", "update Java version", or when modernizing legacy projects./jpa-patternsJPA/Hibernate patterns and common pitfalls (N+1, lazy loading, transactions, queries). Use when user has JPA performance issues, LazyInitializationException, or asks about entity relationships and fetching strategies./logging-patternsJava logging best practices with SLF4J, structured logging (JSON), and MDC for request tracing. Includes AI-friendly log formats for Claude Code debugging. Use when user asks about logging, debugging application flow, or analyzing logs./maven-dependency-auditAudit Maven dependencies for outdated versions, security vulnerabilities, and conflicts. Use when user says "check dependencies", "audit dependencies", "outdated deps", or before releases./performance-smell-detectionDetect potential code-level performance smells in Java - streams, collections, boxing, regex, object creation. Provides awareness, not absolutes - always measure before optimizing. For JPA/database performance, use jpa-patterns instead./security-auditJava security checklist covering OWASP Top 10, input validation, injection prevention, and secure coding. Works with Spring, Quarkus, Jakarta EE, and plain Java. Use when reviewing code security, before releases, or when user asks about vulnerabilities./solid-principlesSOLID principles checklist with Java examples. Use when reviewing classes, refactoring code, or when user asks about Single Responsibility, Open/Closed, Liskov, Interface Segregation, or Dependency Inversion./spring-boot-patternsSpring Boot best practices and patterns. Use when creating controllers, services, repositories, or when user asks about Spring Boot architecture, REST APIs, exception handling, or JPA patterns./test-qualityWrite high-quality JUnit 5 tests with AssertJ assertions. Use when user says "add tests", "write tests", "improve test coverage", or when reviewing/creating test classes for Java code.
README
1claude-code-java
Reusable AI development infrastructure for Java projects, optimized for Claude Code
This project is not affiliated with Anthropic.
What is this?
A collection of reusable components for Claude Code - Anthropic's agentic coding tool. The core of this project is a set of skills (structured markdown files that provide Claude with domain knowledge and workflows), but it also includes project templates, MCP server configurations, and setup scripts.
Who is this for? Java developers using Claude Code who want consistent, high-quality AI assistance for common tasks like code reviews, testing, commits, and architecture decisions.
Purpose
AI-powered development workflows with focus on:
- Token efficiency - Designed for fewer iterations and lower token usage
- Reproducible patterns - Reusable workflows across projects
- Java ecosystem - Tailored for Java/Maven development
- Incremental adoption - Start small, expand as needed
Quick Start
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/.claude/skills/java-code-review your-project/.claude/skills/
# Or symlink all skills
ln -s ~/projects/claude-code-java/.claude/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
Available Skills (18)
Skills are automatically loaded by Claude Code based on context.
Workflow
| Skill | Trigger Examples |
|---|---|
| git-commit | "commit these changes", "create commit" |
| changelog-generator | "generate changelog", "what changed since release" |
| issue-triage | "triage issues", "check open issues" |
Code Quality
| Skill | Trigger Examples |
|---|---|
| java-code-review | "review this code", "check this PR" |
| api-contract-review | "review API", "check REST endpoints" |
| concurrency-review | "check thread safety", "review async code" |
| performance-smell-detection | "check performance", "find slow code" |
| test-quality | "add tests", "improve coverage" |
| maven-dependency-audit | "check dependencies", "audit deps" |
| security-audit | "security review", "check OWASP", "vulnerabilities" |
Architecture & Design
| Skill | Trigger Examples |
|---|---|
| architecture-review | "review architecture", "check package structure" |
| solid-principles | "check SOLID", "single responsibility" |
| design-patterns | "use factory pattern", "implement strategy" |
| clean-code | "clean this code", "refactor" |
Framework & Data
| Skill | Trigger Examples |
|---|---|
| spring-boot-patterns | "create controller", "Spring Boot help" |
| java-migration | "upgrade to Java 21", "migrate from Java 8" |
| jpa-patterns | "N+1 problem", "LazyInitializationException" |
| logging-patterns | "add logging", "debug this flow", "analyze logs" |
See .claude/skills/README.md for full documentation and docs/SCRIPTS.md for setup script options.
Project Structure
claude-code-java/
├── README.md # This file
├── LICENSE # MIT license
├── .gitignore # Git ignore rules
├── .claude/
│ └── skills/ # 18 reusable skills (see Available Skills above)
├── docs/ # Guidelines and best practices
│ ├── DESIGN_PRINCIPLES.md # Core philosophy
│ ├── RED_FLAGS.md # Warning signs to watch for
│ ├── SAFE_WORKFLOWS.md # Step-by-step safe workflows
│ ├── SCRIPTS.md # Scripts documentation
│ ├── SKILL_GUIDELINES.md # How to create new skills
│ └── TESTING.md # Testing strategy
├── templates/
│ ├── CLAUDE.md.template # Template for projects
│ ├── mcp-config.json.template # MCP configuration template
│ ├── MCP_CONFIG.md.template # MCP documentation template
│ └── settings.json.template # Claude Code settings (pre-approved commands)
└── scripts/
├── setup-project.sh # Full project setup (orchestrator)
├── link-skills.sh # Symlink skills to project
├── generate-claude-md.sh # Generate CLAUDE.md
├── configure-mcp.sh # Configure MCP servers
└── test-all.sh # Run all tests
Typical Workflow
- Link skills to your Java project
- Start Claude Code in project directory
- Load skill relevant to current task
- Execute workflow with natural language
- Measure results (tokens used, time saved)
Success Metrics
Track these to validate effectiveness:
- Token reduction: Track your improvement vs manual workflows
- Time savings: Measure before/after per task
- Reusability: Number of projects using skills
- Quality: Code review feedback, test coverage
Requirements
- Claude Code CLI installed
- Java 11+ projects (Java 17+ recommended)
- Git for version control
- Maven or Gradle build tool
- (Optional) GitHub MCP server for issue management
What's Included
- 18 skills (workflow, code quality, architecture, frameworks)
- Setup automation scripts
- Project templates
- YAML frontmatter for automatic skill detection
Used in automated code review
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, a reusable GitHub Actions workflow that evaluates pull requests against the same skills that Claude Code uses during development.
Same skills. From generation to review. See skill-review-sandbox for a working example.
Contributing
Skills are evolving based on real-world usage. Try them, open issues, share what works.
- Try the skills in your projects
- Open issues for suggestions
- Share token savings/improvements
Documentation
See docs/ for detailed guides:
- DESIGN_PRINCIPLES.md - Core philosophy
- SAFE_WORKFLOWS.md - Recommended workflows
- RED_FLAGS.md - Warning signs to watch for
- SKILL_GUIDELINES.md - How to create new skills
License
MIT License - Use freely, modify as needed.
File tree
57decebals/claude-code-javaView on GitHub
.claude/
skills/
api-contract-review/
README.md
SKILL.md
architecture-review/
README.md
SKILL.md
changelog-generator/
README.md
SKILL.md
clean-code/
README.md
SKILL.md
concurrency-review/
README.md
SKILL.md
design-patterns/
README.md
SKILL.md
git-commit/
README.md
SKILL.md
issue-triage/
README.md
SKILL.md
java-code-review/
README.md
SKILL.md
java-migration/
README.md
SKILL.md
jpa-patterns/
README.md
SKILL.md
logging-patterns/
README.md
SKILL.md
maven-dependency-audit/
README.md
SKILL.md
performance-smell-detection/
README.md
SKILL.md
README.md
security-audit/
README.md
SKILL.md
solid-principles/
README.md
SKILL.md
spring-boot-patterns/
README.md
SKILL.md
test-quality/
README.md
SKILL.md
.github/
workflows/
skill-review.yml
.gitignore
docs/
DESIGN_PRINCIPLES.md
RED_FLAGS.md
SAFE_WORKFLOWS.md
SCRIPTS.md
SKILL_GUIDELINES.md
TESTING.md
LICENSE
README.md
scripts/
configure-mcp.sh
configure-settings.sh
generate-claude-md.sh
link-skills.sh
setup-project.sh
test-all.sh
templates/
CLAUDE.md.template
MCP_CONFIG.md.template
mcp-config.json.template
settings.json.templateFAQ
claude-code-java is a Claude Code plugin with 18 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes api-contract-review, architecture-review, changelog-generator. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is claude-code-java?
- Reusable AI development infrastructure for Java projects, optimized for Claude Code This project is not affiliated with Anthropic.
- How do I install claude-code-java?
- Run these in Claude Code: npx -y skills add decebals/claude-code-java --agent claude-code. Then prompt normally.
- Does claude-code-java auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is claude-code-java free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.