Name: amplicode-spring-skills
Author: amplicode

Stats

Actions

Available In

Help us improve

Share bugs, ideas, or general feedback.

Amplicode Spring Skills

Spring Skills is an open set of skills for the Spring Agent Toolkit: proven instructions, workflows, and examples that help AI agents work with Spring Boot projects predictably.

The repository is maintained by the Amplicode and Spring AIO teams and focuses on practical Spring development tasks: exploring an existing application, modifying the Spring Data model, creating DTOs and mappers, adding REST controllers, configuring Spring Security, HTTP automation, and debugging via IntelliJ IDEA.

Why It Matters

Typical AI agents write Spring-like code reasonably well, but they often rely on the style of an "average GitHub project". Real projects are different: they have local conventions for JPA mappings, repositories, DTOs, MapStruct, REST naming, transactions, security, tests, and migrations.

Spring Skills give the agent a narrower, Spring-aware working model:

explore the current application first, and only then change code;

follow the project's conventions instead of inventing new ones;

use structured Spring context from Spring MCP when it is available;

break typical Spring tasks into focused workflows;

run multiple skills together without conflicting instructions.

Quick Start

Install all skills globally into all supported AI agents:

npx skills add Amplicode/spring-skills -g

After that, open a Spring Boot project in your agent and give it a concrete Spring task, for example:

Explore this project and explain its domain model.

Add a CRUD REST controller for Customer using DTOs and MapStruct.

Create a Connekt script that tests the visit creation API.

For the full Spring Agent Toolkit experience, install the Amplicode plugin in IntelliJ IDEA or OpenIDE, open your project, and click "Set Up Spring Agent" on the Amplicode welcome screen. This connects the MCP tools that allow skills to get the Spring structure of the project directly from the IDE.

What's Inside

Skill

What it helps the agent do

Status

spring-explore

Explore a Spring Boot application and gather project context: stack, modules, domain entities, repositories, services, and REST endpoints.

Ready

spring-planning

Create a structured implementation plan in docs/plans/: context gathering, approach selection, and task decomposition.

Ready

spring-data-jpa

Work with JPA entities, repositories, projections, and transactional code following the project's conventions.

Ready

spring-data-jdbc

Work with Spring Data JDBC aggregates, AggregateReference, @MappedCollection, embedded objects, and JDBC repositories.

Ready

crud-rest-controller

Create Spring REST controllers with CRUD endpoints based on a Spring Data repository, optionally with DTOs, mapping, and pagination.

In progress

dto-creator

Create DTOs for entities: Java class, Java record, Java + Lombok, or Kotlin data class.

In progress

mapper-creator

Create mappers between entities and DTOs via MapStruct or a custom converter.

In progress

spring-security-configuration

Generate Spring Security configuration for authentication, authorization, HTTP protection, and supporting beans/properties.

In progress

kafka-configuration

Configure the Spring Boot Kafka starter via application.properties / application.yml and, when needed, generate a KafkaConfiguration.

Ready

connekt-script-writer

Write .connekt.kts scripts for Kotlin-based HTTP automation and endpoint testing.

Ready

java-debug

Debug Java applications via IntelliJ Debug MCP: breakpoints, debug sessions, stepping, evaluate expression, and stack inspection.

In progress

amplicode-install

Install the Amplicode IntelliJ plugin into supported IDEs and guide the user through Spring Agent setup.

Ready

How It Works

The Spring Agent Toolkit combines three layers: