mcpField
S
spring-boot-skill

spring-boot-skill

github.com/sivaprasadreddyDevelopment194465 installsUpdated 2w ago
Repository

About spring-boot-skill

spring-boot-skill provides practice references for developers building Spring Boot applications. It covers configuration, layered design, modularity, and testing, with focused documentation for each area.

Key features

  1. 01Maven configuration and code organization
  2. 02JPA, service layer, and REST APIs
  3. 03Spring Modulith and Thymeleaf
  4. 04Unit, slice, and end-to-end testing
  5. 05Testcontainers and ArchUnit testing

Use cases

  1. 01Configure Maven plugins and code quality
  2. 02Plan a modular Spring Boot package layout
  3. 03Implement persistence, business logic, or REST APIs
  4. 04Design tests for database and web layers

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sivaprasadreddy/sivalabs-agent-skills --skill spring-boot-skill

After installing, type/spring-boot-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
archunit.md
code-organization.md
spring-boot-docker-compose.md
spring-boot-maven-config.md
spring-boot-rest-api-testing.md
spring-boot-webapp-testing-with-mockmvctester.md
spring-data-jpa.md
spring-modulith.md
spring-service-layer.md
spring-webmvc-rest-api.md
taskfile.md
testcontainers-wiring.md
testing-integration.md
testing-slices-persistence.md
testing-slices-web.md
testing-strategy.md
testing-unit-mocking.md
thymeleaf.md

Details

From the project README

Spring Boot Skill

Apply the practices below when developing Spring Boot applications. Read the linked reference only when working on that area.

Maven pom.xml Configuration

Read references/spring-boot-maven-config.md for Maven pom.xml configuration with supporting plugins and configurations to improve code quality, and testing.

Package structure

Read references/code-organization.md for domain-driven, module-based package layout and naming conventions.

Spring Data JPA

Implement the repository and entity layer using references/spring-data-jpa.md.

Service layer

Implement business logic in the service layer using references/spring-service-layer.md.

Spring MVC REST APIs

Implement REST APIs with Spring MVC using references/spring-webmvc-rest-api.md.

Spring Modulith

Build a modular monolith with Spring Modulith using references/spring-modulith.md.

Thymeleaf

If Thymeleaf is used for view templates, refer references/thymeleaf.md

Testing

Write tests at complementary levels — unit, sliced Spring tests, and at least one end-to-end/smoke test; the levels are not either/or. Most framework-touching tests belong at the fast sliced level (@SpringBootTest(classes = …) or a slice annotation); keep full-context @SpringBootTest for a smoke test plus a request-level end-to-end. For why the levels are complementary and how to keep a large suite fast (context caching, one container for the suite), read references/testing-strategy.md.

What you're testingLevelReference
Business/domain logic, no frameworkUnit (no Spring context)testing-unit-mocking.md
JPA / JDBC / JdbcClient / Spring Data JDBC / jOOQ queriesPersistence slice + Testcontainerstesting-slices-persistence.md
Controller, JSON serialization, or a REST clientWeb slice (@WebMvcTest/@JsonTest/@RestClientTest)testing-slices-web.md
A few components together, external HTTP (WireMock), or a startup/request-level smoke testSliced @SpringBootTest(classes = …) or smoke testtesting-integration.md
Full REST API over a real port, full BaseIT suite (RestTestClient)End-to-endspring-boot-rest-api-testing.md
A view-rendering controller (MockMvcTester)Web slicespring-boot-webapp-testing-with-mockmvctester.md
Wiring a container (@ServiceConnection / dynamic properties)—testcontainers-wiring.md

All persistence and integration tests use Testcontainers with a real database (never in-memory H2); see references/testcontainers-wiring.md for @ServiceConnection vs dynamic-property wiring.

Write ArchUnit Tests

To write tests for testing the architecture using ArchUnit, refer references/archunit.md

Spring Boot Docker Compose Support

To use Docker Compose support for local development, refer references/spring-boot-docker-compose.md.

Taskfile

Use references/taskfile.md for easier commands execution.

Comments

Markdown supported