Spring Boot Skills Marketplace

Claude Code skills that help you build Spring Boot apps with architecture that actually fits your needs.

Why This Exists

Projects that start simple tend to grow messy. These skills help you pick the right architecture for where you are now—with a clear path forward when things get complex.

Start simple. Add complexity only when complexity demands it.

Built on patterns from spring-boot-application-architecture-patterns.

Architecture Patterns (Progressive)

Installation

Using Codex? Codex installation and usage instructions are inline below — see Codex (Manual Installation) and Usage → Codex.

Claude Code (Plugin Marketplace)

/plugin marketplace add a-pavithraa/springboot-skills-marketplace
/plugin enable a-pavithraa/springboot-skills-marketplace
/plugin install springboot-architecture@springboot-skills-marketplace

Claude Code (Manual Installation)

# Clone or download this repository
git clone https://github.com/a-pavithraa/springboot-skills-marketplace.git

# Copy skills to Claude Code skills directory
cp -r springboot-skills-marketplace/plugins/springboot-architecture/skills/* ~/.claude/skills/

Codex (Manual Installation)

# Clone or download this repository
git clone https://github.com/a-pavithraa/springboot-skills-marketplace.git

# Copy skills to Codex skills directory
mkdir -p ~/.codex/skills
cp -r springboot-skills-marketplace/plugins/springboot-architecture/skills/* ~/.codex/skills/

Usage

Claude Code

Skills are automatically discovered and loaded when relevant. Claude will invoke them based on your request:

You: "I need to create a new Spring Boot microservice"
Claude: [Automatically loads creating-springboot-projects skill]

You can also explicitly request a skill:

You: "Use the spring-data-jpa skill to optimize this repository"

Codex

Skills must be manually invoked using the $skill-name syntax:

using $creating-springboot-projects create a new order service
using $spring-data-jpa optimize this repository code
using $springboot-migration upgrade to Spring Boot 4
using $code-reviewer review this service implementation

For detailed reference chapters, include the path:

using $spring-data-jpa and ~/.codex/skills/spring-data-jpa/references/dto-projections.md implement efficient queries

Available Skills

creating-springboot-projects

Asks a few questions about your project, then builds the right architecture from the start.

What you get: assessment-driven scaffolding, Spring Initializr setup, and templates for Value Objects, Rich Entities, CQRS patterns, converters—whatever your chosen architecture needs.

Quick assessment covers:

• Domain complexity (CRUD vs. business rules)
• Team size and project lifespan
• Type safety requirements
• Bounded contexts

spring-data-jpa

Helps you write JPA code that doesn't slow down six months later.

Covers query patterns, DTO projections, custom repositories, CQRS query services, and the performance anti-patterns that bite everyone eventually (repositories for every entity, method-name query hell, blind save() calls).

springboot-migration

Step-by-step migration to Spring Boot 4 + Java 25 (with Spring Modulith 2 and Testcontainers 2 support).

Scans your project first, then walks through dependencies → code → config in phases. Includes retry/resilience patterns and references for each upgrade target.

code-reviewer

Sanity-checks your Boot 4 / Java 25 project for architecture fit and performance gotchas.

Covers all five architecture patterns (when to use, when to avoid), plus checklists for events, CQRS, Modulith boundaries. Catches N+1 queries, missing caches, virtual thread pinning, and other performance traps.

Use this when you want a second opinion or need to decide if it's time to evolve your architecture.

Usage Examples

"I need a REST API for products with basic CRUD."
→ Asks about your domain, team, and timeline. Suggests Layered architecture. Generates scaffolding.

"I need an order service with payments and inventory rules."
→ Assesses complexity. Recommends Tomato architecture. Generates value objects, rich entities, CQRS services.

"My product search is slow."
→ Analyzes your queries, spots N+1 issues, refactors to DTO projections.

"We need to migrate from Boot 3 to Boot 4."
→ Runs migration scanner, plans phased upgrade (dependencies → code → config), applies and verifies each step.

"Can you review our Boot 4 service for issues?"
→ Checks architecture pattern fit, hunts for performance problems (N+1, missing caches, virtual thread pinning, entity leaks).

Templates & Assets

Architecture templates (creating-springboot-projects/assets/)
Value Objects, Rich Entities, CQRS services, converters, REST controllers, Flyway migrations, Testcontainers, ProblemDetail handlers.

JPA templates (spring-data-jpa/assets/)
Query repositories, DTO projections, custom repos, CQRS query services, relationship patterns.

Reviewer references (code-reviewer/references/)
Architecture patterns, decision matrices, performance checklists.

Reference guides (spring-data-jpa/references/)
Query patterns, projections, custom repositories, relationship handling, performance tuning.

Testing Skills

Want to verify skills work as intended? See the tests/ directory for baseline scenarios.

Quick start:

# Run one scenario in 5 minutes
cd tests
cat QUICKSTART.md

Full test suite:

• 8 baseline scenarios defined for each skill's core behaviors
• RED-GREEN-REFACTOR methodology
• Rationalization tracking
• See tests/README.md for complete testing guide

Current coverage: the harness is set up for all 8 scenarios, but only Scenario 7 (code-reviewer review rigor) has actually been executed and recorded in tests/baseline-results/scenario-7.md. Scenarios 1–6 and 8 are defined in tests/baseline-scenarios.md and ready to run, but no baseline/target results exist for them yet. Contributions welcome.

Based on terraform-skill testing approach.

Prerequisites

• Claude Code CLI
• Java 17+ (Java 25 recommended for new projects)
• Maven or Gradle
• Spring Boot 4.1+ familiarity

Evolution Path

Start simple, evolve as needed:

Layered → Package-by-Module → Modular Monolith → Tomato → DDD+Hexagonal

Credits

• Architecture patterns: Siva Prasad Reddy
• Spring Boot 4 features: spring-boot-4-features
• Modular monolith reference: spring-modular-monolith
• Marketplace inspiration: sivalabs-marketplace
• JPA/Hibernate best practices: Vlad Mihalcea