spring-skills

Spring Skills

A curated collection of agent-agnostic skills for the Spring (Java) ecosystem. Each skill is a self-contained markdown file that any AI coding assistant can consume to provide expert-level guidance.

What is a Skill?

A skill is a structured markdown document that teaches an AI assistant how to guide you through a specific technology or practice. Skills contain best practices, conventions, decision frameworks, anti-patterns, and code examples — distilled from official documentation and real-world experience.

Available Skills

Skill	Status	Description
spring-framework	Reviewed	DI, bean lifecycle, AOP, proxy mechanics, @Transactional, @Async
spring-boot	Reviewed	Project setup, configuration, observability, virtual threads, dev services
spring-modulith	Reviewed	Module boundaries, events, verification, testing
spring-security	Draft	OAuth2, JWT, security filters, method security
spring-data-jpa	Draft	Entities, repositories, queries, projections
spring-web	Draft	REST controllers, validation, error handling, CORS
spring-testing	Draft	MockMvc, Testcontainers, Spock, test slices
spring-events	Reviewed	Application events, transactional listeners, async processing, event publication registry
spring-flyway	Draft	Database migrations, naming, versioning, module-aware migrations
spring-kafka	Draft	Consumers, producers, error handling, testing
spring-graphql	Draft	DGS/Spring GraphQL, federation, data loaders
spring-ai	Reviewed	ChatClient, structured output, tool calling, RAG, advisors, MCP
spring-versions	Reviewed	Version numbers, release schedule, compatibility matrix, support timelines

Note: spring-framework, spring-boot, spring-modulith, spring-events, spring-ai, and spring-versions have been reviewed and refined. All other skills are initial drafts and still work in progress.

See CATALOG.md for a browsable index with tags.

How to Use

Quick Start

1. Pick the skill(s) relevant to your project from the catalog
2. Feed the skill content to your AI assistant using one of the integration methods below

Claude Code (Plugin)

Install all skills at once as a Claude Code plugin:

/plugin marketplace add https://gitlab.com/rynr/spring-skills.git
/plugin install spring-skills@rynr-spring-skills

Other AI Tools

Each tool has its own convention for loading context. Copy or reference the skill file accordingly:

AI Tool	Where to place the skill
Claude Code	.claude/skills/<skill-name>/SKILL.md or reference in CLAUDE.md
Cursor	.cursor/rules/<skill-name>.md
GitHub Copilot	Reference in .github/copilot-instructions.md
Windsurf	.windsurfrules or .windsurf/rules/<skill-name>.md
Amp	.amp/skills/<skill-name>.md
Cline	.cline/rules/<skill-name>.md

Any LLM / Chat Interface — Paste the skill content into your system prompt or conversation context.

Consult your AI tool's documentation for the most current instructions on loading custom context.

Combining Skills

Skills are designed to be composable. Pick only the ones relevant to your project. For a typical Spring Boot web application, you might use:

• spring-framework + spring-boot + spring-web + spring-data-jpa + spring-testing + spring-flyway

For an event-driven modular application:

• spring-framework + spring-boot + spring-modulith + spring-events + spring-kafka + spring-testing

Agents

When installed as a Claude Code plugin, the following agents are available:

Agent	Description
spring-project-analyzer	Scans a Spring Boot project against skill best practices. Identifies relevant skills, detects anti-patterns, reviews configuration, and produces a structured report

Agents are triggered automatically when Claude Code detects a matching request (e.g., "analyze this project for Spring best practices").

Skill Format

Each skill follows a consistent format documented in FORMAT.md. Skills use YAML frontmatter for metadata and structured markdown for content. This makes them parseable by tools while remaining human-readable.

Contributing

Want to improve a skill or add a new one? See FORMAT.md for the skill authoring guide.

License

MIT