About spring-data-jpa
spring-data-jpa is a Spring Agent Toolkit skill for creating or modifying JPA entities, reviewing JPA patterns, and handling transactional behavior. It directs work through project conventions and implementation rules.
Key features
- 01Create or modify JPA entities
- 02Detect and reuse entity conventions
- 03Review JPA patterns against best practices
- 04Apply transaction conventions and rules
Use cases
- 01Implement a JPA entity in an existing project
- 02Review entity patterns and code quality
- 03Add or modify transactional behavior
MCP support
Requires the Spring MCP server provided by the Amplicode IntelliJ plugin; its preflight checks for available Amplicode tools before proceeding.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ amplicode/ spring-skills --skill spring-data-jpaAfter installing, type/spring-data-jpain Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/entity-conventions.mdentity-rules-impl.mdrepository-conventions.mdtransaction-conventions.mdtransaction-oregination.mdtransaction-rules-impl.mdDetails
From the project READMEPreflight: Spring MCP
This skill is part of the Spring Agent Toolkit and is designed to work with the Spring MCP server (provided by the Amplicode IntelliJ plugin). Before doing anything else, check your tool list for any Spring MCP tool — they are exposed under the amplicode MCP server (e.g. get_project_summary, list_module_dependencies, get_entity_details); harnesses that flatten MCP tools into the tool list use the mcp__amplicode__ prefix on the same names.
- If at least one Amplicode tool is available — MCP is connected. Proceed with the skill below.
- If none are available — stop and invoke the
amplicode-installskill (bundled with the Spring Agent Toolkit). It installs the Amplicode plugin and walks the user through the «Настроить Spring Agent» welcome-screen button + MCP-client restart. After it completes, the MCP tools become available — resume this skill. - If
amplicode-installis not registered in your skill list, tell the user (in their language): "This skill needs the Amplicode IntelliJ plugin and its MCP server. Install it from https://amplicode.ru/marketplace into IntelliJ IDEA Ultimate/Community or GigaIDE, open any project, click «Настроить Spring Agent» on the Amplicode welcome screen, then restart your MCP client."
Working with JPA Entities
When the task involves creating or modifying a JPA entity:
- If entity conventions have not been detected yet in this conversation — check memory for previously saved conventions first. If found in memory, reuse them. Otherwise read
references/entity-conventions.mdand follow all substeps there to detect project conventions. - Read
references/entity-rules-impl.mdand follow the rules there when writing or modifying the entity
Reviewing JPA Patterns
When the user asks to review JPA patterns, conventions, or code quality in the project:
- Detect current conventions by following
references/entity-conventions.md(steps 1.1–1.5). - Compare the detected conventions against the best practices defined in
references/entity-rules-impl.md. For each deviation, output a recommendation in the format:
### JPA Review
**[Convention or pattern name]**
- Current: <what the project does>
- Recommended: <what the best practice says>
- Reason: <why this matters>
If no deviations are found — state that the project follows best practices.
Working with Transactions
When the task involves adding or modifying transactional behavior:
- If transaction conventions have not been detected yet in this conversation — check memory for previously saved conventions first. If found in memory, reuse them. Otherwise read
references/transaction-conventions.mdand follow all substeps there to detect project conventions. - Read
references/transaction-rules-impl.mdand follow the rules there when writing or modifying transactional code.