Agent skill

Spring Data Jpa

by rrezartprebreza in rrezartprebreza/spring-boot-skills

A skill your agent uses when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings.

MITAuto-check passedBackend & APIs

Install Spring Data Jpa

skills CLI
$ npx skills add rrezartprebreza/spring-boot-skills --skill spring-data-jpa -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rrezartprebreza/spring-boot-skills spring-data-jpa --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/spring-boot-4/spring-data-jpa .claude/skills/spring-data-jpa && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spring-data-jpa
GitHub stars
301
Token cost
~3k tokens
SKILL.md length
772 words
Files
5
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings.

  • Refactoring Spring Boot 4 JPA entities
  • SKILL.md covers Entity Model Rules, Embeddables and DTOs, Relationships and equals and hashCode, plus 6 more sections
  • Runs Java scripts from its folder
  • Persistence tests

What it does

Spring Data Jpa is an agent skill from rrezartprebreza/spring-boot-skills. Use when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings. Covers Jakarta Persistence 3.2 imports, Hibernate 7 entity modeling, new-state detection, N+1 prevention, projections, keyset pagination, batch writes, and common agent mistakes.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `agents/openai.yaml`).

It sits in Backend & APIs, covering Backend development, ORMs and data access and Diagrams. It works with Spring Boot. The repository describes itself as: Production-grade Claude Code and Codex skills for Spring Boot developers. The licence is MIT.

When your agent uses it

  • Refactoring Spring Boot 4 JPA entities
  • Persistence tests
  • Entity relationships
  • Hibernate mappings

Example prompts

  • “/spring-data-jpa”

What it can do on your machine

Read from SKILL.md and the folder at commit f0c06a0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Java), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spring Data Jpa loads about 3k tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 772 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rrezartprebreza/spring-boot-skills at commit f0c06a0, republished under its MIT licence (© rrezartprebreza). 772 words, ~3,041 tokens.

Download SKILL.mdSave it as .claude/skills/spring-data-jpa/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
spring-data-jpa
description
Use when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings. Covers Jakarta Persistence 3.2 imports, Hibernate 7 entity modeling, new-state detection, N+1 prevention, projections, keyset pagination, batch writes, and common agent mistakes.

Spring Data JPA (Boot 4 / Hibernate 7)

Spring Boot 4 manages Jakarta Persistence 3.2, Jakarta Validation 3.1, and Hibernate ORM 7.x. Use Boot dependency management and import jakarta.persistence.* / jakarta.validation.*. Do not add explicit Hibernate, JPA, or Validator versions unless the project has a deliberate override policy.

Entity Model Rules

Use an @Entity only for persistent state with identity and lifecycle. Use records for DTOs, commands, and read models. Use @Embeddable for values stored inside an entity table.

java
@Entity
@Table(name = "orders", indexes = {
    @Index(name = "idx_orders_customer_id", columnList = "customer_id"),
    @Index(name = "idx_orders_status_created", columnList = "status, created_at")
})
@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
public class Order {

    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    @Column(nullable = false, updatable = false)
    private UUID id;

    @Version
    private Long version;

    @Column(name = "customer_id", nullable = false, updatable = false)
    private UUID customerId;

    @Enumerated(EnumType.STRING)
    @Column(nullable = false, length = 32)
    private OrderStatus status;

    @Embedded
    private Money total;

    @OneToMany(mappedBy = "order", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<OrderItem> items = new ArrayList<>();

    @CreationTimestamp
    @Column(name = "created_at", nullable = false, updatable = false)
    private Instant createdAt;

    @UpdateTimestamp
    @Column(name = "updated_at", nullable = false)
    private Instant updatedAt;

    public static Order create(UUID customerId) {
        Order order = new Order();
        order.customerId = Objects.requireNonNull(customerId);
        order.status = OrderStatus.DRAFT;
        order.total = Money.zero("EUR");
        return order;
    }

    public void addItem(UUID productId, int quantity, Money unitPrice) {
        if (status != OrderStatus.DRAFT) {
            throw new IllegalStateException("Cannot edit submitted order");
        }
        items.add(OrderItem.create(this, productId, quantity, unitPrice));
        recalculateTotal();
    }

    private void recalculateTotal() {
        total = items.stream()
            .map(OrderItem::subtotal)
            .reduce(Money.zero("EUR"), Money::add);
    }
}

Rules:

  • Use jakarta.persistence.*, never javax.persistence.*.
  • Keep entities non-final with a protected no-arg constructor so Hibernate can instantiate/proxy them.
  • Do not use Java records for ordinary entities. Records are good DTOs and sometimes embeddables.
  • Use targeted Lombok (@Getter, protected @NoArgsConstructor), not @Data or broad @Setter.
  • Prefer behavior methods and static factories over public setters/constructors.
  • Initialize collections inline. JPA collection fields should not be null.
  • Use @Enumerated(EnumType.STRING) with explicit column length. Never use ORDINAL.
  • Add @Version Long version for user-editable aggregates. Use wrapper Long, not primitive long.
  • Prefer UUID or pooled sequence IDs. Avoid GenerationType.IDENTITY on high-write tables because it disables insert batching.
  • Validate request DTOs at the boundary; enforce entity invariants inside behavior methods.

Embeddables and DTOs

java
@Embeddable
public record Money(
    @Column(name = "amount", nullable = false, precision = 19, scale = 2)
    BigDecimal amount,

    @Column(name = "currency", nullable = false, length = 3)
    String currency
) {
    public Money {
        Objects.requireNonNull(amount);
        Objects.requireNonNull(currency);
        if (amount.signum() < 0) {
            throw new IllegalArgumentException("Amount cannot be negative");
        }
    }

    public static Money zero(String currency) {
        return new Money(BigDecimal.ZERO, currency);
    }

    public Money add(Money other) {
        if (!currency.equals(other.currency)) {
            throw new IllegalArgumentException("Currency mismatch");
        }
        return new Money(amount.add(other.amount), currency);
    }

    public Money multiply(int quantity) {
        if (quantity < 1) {
            throw new IllegalArgumentException("Quantity must be positive");
        }
        return new Money(amount.multiply(BigDecimal.valueOf(quantity)), currency);
    }
}

Never expose entities from controllers. Map entities to response records:

java
public record OrderResponse(UUID id, String status, BigDecimal total, Instant createdAt) {
    static OrderResponse from(Order order) {
        return new OrderResponse(
            order.getId(),
            order.getStatus().name(),
            order.getTotal().amount(),
            order.getCreatedAt());
    }
}

Relationships

Map the database shape first. Prefer normal foreign keys: @ManyToOne on the owning side and @OneToMany(mappedBy = ...) only when parent-to-child navigation is actually needed.

java
@Entity
@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
class OrderItem {

    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;

    @ManyToOne(fetch = FetchType.LAZY, optional = false)
    @JoinColumn(name = "order_id", nullable = false, foreignKey = @ForeignKey(name = "fk_order_item_order"))
    private Order order;

    @Column(name = "product_id", nullable = false, updatable = false)
    private UUID productId;

    private int quantity;
    private Money unitPrice;

    static OrderItem create(Order order, UUID productId, int quantity, Money unitPrice) {
        OrderItem item = new OrderItem();
        item.order = Objects.requireNonNull(order);
        item.productId = Objects.requireNonNull(productId);
        item.quantity = quantity;
        item.unitPrice = Objects.requireNonNull(unitPrice);
        return item;
    }

    Money subtotal() {
        return unitPrice.multiply(quantity);
    }
}
  • Put fetch = FetchType.LAZY on @ManyToOne and @OneToOne; to-one mappings are eager by default.
  • Avoid unbounded bidirectional graphs. Add back-references only when required.
  • Use orphanRemoval = true only when the parent truly owns the child's lifecycle.
  • Avoid @ManyToMany for business relationships with attributes; model the join row as an entity.
  • Do not serialize lazy relationships to JSON. Map to DTOs inside a transaction.

equals and hashCode

Do not generate entity equality with Lombok @Data. It includes mutable fields and associations, which can trigger lazy loading, recursion, and hash changes.

Preferred options:

  • If the entity has a stable natural key, base equality on that key and enforce a unique database constraint.
  • If it only has a generated ID, keep default object identity unless the project already has a proxy-safe generated-ID pattern.
  • Never include collections, mutable fields, or associations in equals, hashCode, or toString.
  • Use instanceof, not getClass(), when equality must work with Hibernate proxies.
java
@Override
public boolean equals(Object other) {
    return other instanceof Customer that
        && email != null
        && email.equals(that.getEmail());
}

@Override
public int hashCode() {
    return email == null ? 0 : email.hashCode();
}

Repositories and Query Patterns

java
public interface OrderRepository extends JpaRepository<Order, UUID> {

    boolean existsByCustomerIdAndStatus(UUID customerId, OrderStatus status);

    Optional<Order> findByIdAndCustomerId(UUID id, UUID customerId);

    @EntityGraph(attributePaths = {"items"})
    Optional<Order> findById(UUID id);

    @Query("""
        select o
        from Order o
        where o.status = :status
        order by o.createdAt desc, o.id desc
        """)
    List<Order> findRecentByStatus(OrderStatus status, Limit limit);
}

Use:

  • Derived queries for simple filters.
  • @Query for explicit joins, keyset pagination, and complex predicates.
  • @EntityGraph for bounded graph loading.
  • Projections for read-only API views.
  • exists... queries instead of find...().isPresent() checks.

Avoid:

  • findAll() in endpoints.
  • Native SQL unless JPQL cannot express the query or the database-specific feature is intentional.
  • Returning entities for read-only list views when a projection is enough.

N+1 Prevention

Identify N+1 by looking for lazy association access inside loops or JSON serialization of entities.

java
@EntityGraph(attributePaths = {"items", "items.product"})
Optional<Order> findWithItemsAndProductsById(UUID id);

public interface OrderSummary {
    UUID getId();
    UUID getCustomerId();
    OrderStatus getStatus();
    Instant getCreatedAt();
}

List<OrderSummary> findByStatus(OrderStatus status);

Use fetch joins and entity graphs only for bounded relationships. For list endpoints, prefer projections to avoid loading entire aggregate graphs.

Show full SKILL.md (292 more words)Show less

Pagination

Use Pageable for normal list screens:

java
Page<Order> findByStatus(OrderStatus status, Pageable pageable);

Use keyset pagination for deep or infinite-scroll lists. OFFSET pagination scans and discards skipped rows.

java
@Query("""
    select o
    from Order o
    where o.status = :status
      and (o.createdAt < :lastCreatedAt
           or (o.createdAt = :lastCreatedAt and o.id < :lastId))
    order by o.createdAt desc, o.id desc
    """)
List<Order> findNextPage(OrderStatus status, Instant lastCreatedAt, UUID lastId, Limit limit);

The (createdAt, id) tuple keeps the cursor stable when timestamps collide. Back it with an index like (status, created_at desc, id desc).

Batch Writes

Enable JDBC batching for write-heavy workloads:

yaml
spring:
  jpa:
    properties:
      hibernate:
        jdbc.batch_size: 50
        order_inserts: true
        order_updates: true

GenerationType.IDENTITY disables insert batching because Hibernate needs the generated key after each row. Use UUIDs or pooled sequences when batch insert throughput matters.

New-State Detection

Spring Data JPA detects new entities by nullable wrapper @Version first, then nullable ID. A primitive version cannot be used because JPA treats 0 as the first persisted version.

For manually assigned IDs, add @Version Long version or implement Persistable with an isNew flag cleared by @PostPersist and @PostLoad. Use the template in templates/BaseAssignedIdEntity.java.

Gotchas

  • Agent imports javax.persistence.* - Boot 4 uses jakarta.persistence.*.
  • Agent creates entity records - use records for DTOs/embeddables, not ordinary entities.
  • Agent puts @Data on entities - generates setters and unsafe equality; use targeted @Getter.
  • Agent makes entities final or constructors private - breaks Hibernate proxy/instantiation.
  • Agent uses FetchType.EAGER - use LAZY on to-one and many-to-many relationships.
  • Agent uses @Enumerated(EnumType.ORDINAL) - use STRING.
  • Agent uses primitive long version - use nullable wrapper Long.
  • Agent omits @Version on editable aggregates - lost updates are not detected.
  • Agent returns entities from controllers - map to DTO records.
  • Agent calls findAll() for list endpoints - require Pageable, Limit, or a projection query.
  • Agent uses OFFSET pagination on huge tables - switch to keyset for deep pages.
  • Agent includes lazy associations in equality or toString - causes lazy loads and recursion.
  • Agent maps every relationship bidirectionally - add back-references only when required.
  • Agent uses @ManyToMany for business links with attributes - model the join row as an entity.
  • Agent batches inserts with GenerationType.IDENTITY - batching is silently off; use UUID/sequence.

© rrezartprebreza, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in skills/spring-boot-4/spring-data-jpa of rrezartprebreza/spring-boot-skills.

  • SKILL.md
  • agents/openai.yaml
  • examples/bad-entity.java
  • examples/good-entity.java
  • templates/BaseAssignedIdEntity.java

Open the folder on GitHubat commit f0c06a0

Compare with similar skills

Spring Data Jpa next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spring Data Jpa compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spring Data Jpa this skillrrezartprebreza/spring-boot-skills301—~3kAutomated safety check: PassMIT
Grails Developer Guideapache/grails-core2.9k—~4.9kAutomated safety check: PassApache-2.0
Bootui Java Developmentjdubois/boot-ui314—~1.3kAutomated safety check: PassApache-2.0
Java ArchitectJeffallan/claude-skills12k—~1.5kAutomated safety check: PassMIT
Spring Boot EngineerJeffallan/claude-skills12k—~1.9kAutomated safety check: PassMIT
Jpa Patternsaffaan-m/ECC276k3 repos~847Automated safety check: PassMIT

Similar skills

  • Grails Developer Guide

    apache/grails-core

    Guides building Grails web applications and REST APIs with GORM, controllers, services, views, plugins and Spock and Geb testing.

    2.9k GitHub stars~4.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • A skill your agent uses when implementing, debugging, refactoring, or testing existing BootUI Java code, including framework-neutral engine logic, Spring MVC and WebFlux adapters, Quarkus runtime…

    314 GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Java Architect

    Jeffallan/claude-skills

    Builds Spring Boot 3.x services on Java 21 with domain-driven design, WebFlux, JPA tuning and Spring Security using OAuth2 and JWT, verified by Maven or Gradle builds.

    12k GitHub stars~1.5k tokensUpdated 7 days ago
    Backend & APIsAuto-check passed
  • Spring Boot Engineer

    Jeffallan/claude-skills

    Builds Spring Boot 3.x services with REST controllers, Spring Data JPA, Spring Security 6, WebFlux and Spring Cloud, verified by tests and Actuator health checks.

    12k GitHub stars~1.9k tokensUpdated 7 days ago
    Backend & APIsAuto-check passed
  • Jpa Patterns

    affaan-m/ECC

    Spring Boot中的JPA/Hibernate模式,用于实体设计、关系处理、查询优化、事务管理、审计、索引、分页和连接池。

    276k GitHub starsUsed in 3 repos~847 tokens
    Backend & APIsAuto-check passed
  • Senior Java

    benchflow-ai/skillsbench

    World-class Java and Spring Boot development skill for enterprise applications, microservices, and cloud-native systems.

    1.8k GitHub stars~5k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from rrezartprebreza/spring-boot-skills

All 51 skills in this repo
  • AI Observability

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when adding Spring AI-specific model observations, token usage, latency, externally configured cost attribution, advisor telemetry, or protected prompt and completion logging.

    301 GitHub stars~1.6k tokensUpdated 19 days ago
    Auto-check passed
  • API Versioning

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when versioning Spring MVC or WebFlux APIs in Spring Boot 3 / Spring Framework 6.

    301 GitHub stars~516 tokensUpdated 19 days ago
    Auto-check passed
  • API Versioning

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when versioning Spring MVC or WebFlux APIs in Spring Boot 4 / Spring Framework 7.

    301 GitHub stars~643 tokensUpdated 19 days ago
    Auto-check passed
  • Container Native Deployment

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when packaging a Spring Boot 3 application as an OCI image or GraalVM native executable.

    301 GitHub stars~781 tokensUpdated 19 days ago
    Auto-check passed
  • Container Native Deployment

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when packaging Spring Boot 4 as an OCI image, JVM container, AOT application, or GraalVM native executable.

    301 GitHub stars~706 tokensUpdated 19 days ago
    Auto-check passed
  • Domain Driven Design

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when evolving aggregate invariants, value objects or domain events in an existing DDD-style Spring Boot 3 application, or when DDD is explicitly requested.

    301 GitHub stars~2.1k tokensUpdated 19 days ago
    Auto-check passed

Works with

Questions about Spring Data Jpa

What does Spring Data Jpa do?

A skill your agent uses when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings. Spring Data Jpa is an agent skill from rrezartprebreza/spring-boot-skills. Use when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings.

When should I use Spring Data Jpa?

Spring Data Jpa fits situations like: refactoring Spring Boot 4 JPA entities; persistence tests; entity relationships; hibernate mappings.

How do I install Spring Data Jpa in Claude Code?

Run `npx skills add rrezartprebreza/spring-boot-skills --skill spring-data-jpa -a claude-code`. Or copy the skill folder (skills/spring-boot-4/spring-data-jpa in rrezartprebreza/spring-boot-skills) into .claude/skills/spring-data-jpa in your project. Claude Code loads it when a task matches its description.

How do I install Spring Data Jpa in Codex?

Run `npx skills add rrezartprebreza/spring-boot-skills --skill spring-data-jpa -a codex`. Or copy the skill folder (skills/spring-boot-4/spring-data-jpa in rrezartprebreza/spring-boot-skills) into .agents/skills/spring-data-jpa in your project. Codex loads it when a task matches its description.

Can I use Spring Data Jpa in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rrezartprebreza/spring-boot-skills --skill spring-data-jpa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spring-data-jpa, .gemini/skills/spring-data-jpa, .github/skills/spring-data-jpa and .opencode/skills/spring-data-jpa in your project.

What does Spring Data Jpa need to run?

Going by SKILL.md and its folder, Spring Data Jpa needs Java for the scripts in its folder.

Does Spring Data Jpa access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spring Data Jpa safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spring Data Jpa use?

Spring Data Jpa is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spring Data Jpa use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spring Data Jpa?

Skills that share tags, products or a category with Spring Data Jpa: Grails Developer Guide (apache/grails-core, 2.9k stars), Bootui Java Development (jdubois/boot-ui, 314 stars), Java Architect (Jeffallan/claude-skills, 12k stars) and Spring Boot Engineer (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spring Data Jpa?

rrezartprebreza (a GitHub user) maintains it in rrezartprebreza/spring-boot-skills, which has 301 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on September 21, 2026.

Source: rrezartprebreza/spring-boot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.