Production-grade Spring Boot skills for Claude Code and Codex. Drop a skill into your project and your AI coding agent instantly understands your architecture, patterns, and conventions.
Quick Start · Skills Catalog · Before / After · Skill Anatomy · Contributing
Why this exists
AI coding agents are great at Python. They hallucinate in Spring Boot.
They generate @Autowired field injection instead of constructor injection. They use ResponseEntity<?> where you have a standard response wrapper. They ignore your existing exception hierarchy and invent a new one. They don't know your project uses Flyway, so they generate schema SQL by hand. They emit pre-GA Spring AI artifact names that no longer exist in Maven Central.
Skills fix this. A skill is a markdown file your agent reads before touching your code. It tells the agent your conventions, your stack, your gotchas — not generic Spring Boot from 2020.
flowchart LR
A["💬 You ask:<br/>"add an orders endpoint""] --> B{Agent matches<br/>skill triggers}
B -->|"REST code?"| C["📜 rest-api-conventions"]
B -->|"persistence?"| D["📜 spring-data-jpa"]
C --> E["🤖 Agent codes with<br/>YOUR envelope, YOUR<br/>status mapping, YOUR<br/>pagination contract"]
D --> E
E --> F["✅ Code that looks like<br/>your team wrote it"]
style A fill:#0f172a,stroke:#38bdf8,color:#e2e8f0
style B fill:#1e293b,stroke:#94a3b8,color:#e2e8f0
style C fill:#10241a,stroke:#6DB33F,color:#a7f3d0
style D fill:#10241a,stroke:#6DB33F,color:#a7f3d0
style E fill:#0f172a,stroke:#d97757,color:#e2e8f0
style F fill:#10241a,stroke:#6DB33F,color:#a7f3d0
This repo is a collection of battle-tested skills. Copy, adapt, drop in.
Verify your conventions with AgentAccord
AgentAccord is a free, MIT-licensed companion tool for checking team engineering rules in source code and AI instruction files.
Spring Boot Skills teaches your agent how to work. AgentAccord checks supported rules your team has explicitly approved. It can flag field injection in application code, conflicting instructions in AGENTS.md, CLAUDE.md, and SKILL.md, and policy violations in supported Java examples. Run it locally through its CLI or browser app, or use its GitHub Action in CI.
Choose policies that fit your project. For example, restrictions on @Value or @WebMvcTest are optional team decisions, not universal Spring Boot rules. AgentAccord checks a defined set of patterns; it does not automatically enforce every recommendation in this skills catalog.
Get started with AgentAccord · See the v0.4.0 release
🧠 Concepts
| Concept | Description |
|---|
| Skills | Markdown files loaded into Claude Code or Codex context — tell the agent how to work in your codebase |
| CLAUDE.md / AGENTS.md | Project-level persistent memory — your agent's onboarding doc |
| MCP Java SDK | Official Java SDK for building MCP servers — connect your Spring Boot app to any AI agent |
| Marketplace plugins | Versioned Claude Code and Codex packages for all Boot 3 or Boot 4 skills |
| Project templates | Ready-to-adapt CLAUDE.md and AGENTS.md guidance for Boot 3 and Boot 4 projects |
| Planned workflows | Repeatable commands such as /generate-endpoint, /write-test, and /db-migrate are listed in the roadmap |
📦 Skills
The catalog ships in two version trees — pick the folder that matches your stack. Shared topics
normally have both flavors; genuinely version-specific topics may live only in the relevant tree.
| Folder | Target stack | Compatibility baseline |
|---|
skills/spring-boot-4/ | Spring Boot 4.x · Spring Framework 7 · Spring Security 7 · Spring Batch 6 · Jackson 3 · Spring AI 2.0 | Java 17+; examples use Java 21; Boot 4.0.x and 4.1.x |
skills/spring-boot-3/ | Spring Boot 3.x · Spring Framework 6 · Spring Security 6 · Spring Batch 5 · Jackson 2 · Spring AI 1.x | Java 17+; examples use Java 21 |
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
