quarkus-panache-smells

Detect ORM code smells in Quarkus Panache repositories and propose refactors.

1|1|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/emvnuel/SKILL.md --skill quarkus-panache-smells
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quarkus-panache-smells
Source: https://github.com/emvnuel/SKILL.md/tree/main/quarkus-panache
Command: npx skills add https://github.com/emvnuel/SKILL.md --skill quarkus-panache-smells

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill detects and refactors ORM code smells in Quarkus Panache applications using the Repository pattern. Use when reviewing PanacheRepository code, diagnosing N+1 queries, data overfetching, or pagination issues.

Core Features & Use Cases

  • Detects common ORM smells such as eager loading, missing projections, and N+1 patterns, and suggests targeted refactors.
  • Guides pagination-safe queries and efficient data access via Panache repositories.
  • Provides practical examples and recommended repository/query patterns for real-world projects.

Quick Start

Run quarkus-panache-smells on your PanacheRepository codebase to detect smells and receive concrete refactor steps.

Frequently Asked Questions about quarkus-panache-smells

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix N+1 query issues in Quarkus Panache repositories?

To fix N+1 query issues in Quarkus Panache repositories, you must detect eager loading patterns and refactor repository methods to use projections or pagination-safe queries. This skill identifies these ORM smells and suggests concrete refactoring steps to optimize data access.

What are common ORM code smells in Quarkus Panache applications?

Common ORM code smells in Quarkus Panache include eager fetching, missing projections, N+1 query patterns, data overfetching, and pagination issues. These typically occur when reviewing PanacheRepository usage and can be resolved by applying targeted repository method refactors.

How do I prevent data overfetching when using PanacheRepository?

To prevent data overfetching with PanacheRepository, you should replace eager loading with targeted projections and pagination-safe queries. This skill guides you through diagnosing overfetching smells and applying efficient data access patterns via repository methods.

Does this refactoring approach work with the Quarkus Panache Repository pattern specifically?

Yes, this refactoring approach specifically targets the Quarkus Panache Repository pattern. It analyzes PanacheRepository codebases to diagnose ORM smells like N+1 queries and missing projections, then guides changes directly through repository methods and projections.

When should I refactor eager loading in Quarkus Panache?

You should refactor eager loading in Quarkus Panache when diagnosing N+1 queries, data overfetching, or pagination issues in your codebase. This skill detects these performance smells and recommends practical repository query patterns to ensure efficient data retrieval.