# java-quarkus-development

Development guidelines for building Quarkus microservices. It directs the coding agent to handle reactive endpoints, Panache data access, and GraalVM native builds.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 836 installs · ★ 286
- Author: Mindrally
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Mindrally/skills/tree/HEAD/java-quarkus-development/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/java-quarkus-development

## What it does

This skill guides coding assistants through Quarkus development patterns. It focuses on RESTEasy Reactive for HTTP APIs, paired with Mutiny for non-blocking execution. For persistence, the instructions direct the model toward Hibernate ORM with Panache using either the active record or repository pattern. Database migrations rely on Flyway or Liquibase.

Native image creation via GraalVM requires strict limits on reflection. The instructions explicitly enforce `@RegisterForReflection` only when needed, avoiding reflection-heavy structures that break ahead-of-time builds. Constructor injection remains the preferred CDI approach.

Application telemetry follows MicroProfile specifications. The agent writes readiness and liveness checks for Kubernetes probes, alongside Prometheus metrics export.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill java-quarkus-development -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/java-quarkus-development/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/java-quarkus-development/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill java-quarkus-development -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/java-quarkus-development/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill java-quarkus-development -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/java-quarkus-development/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Mindrally/skills java-quarkus-development
```

2. **Manually: put the files in place**
- File: `.github/skills/java-quarkus-development/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill java-quarkus-development -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Mindrally/skills --path java-quarkus-development
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/java-quarkus-development/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill java-quarkus-development -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Mindrally/skills/tree/HEAD/java-quarkus-development/SKILL.md

## When to use it
- Build reactive REST endpoints using Mutiny and RESTEasy Reactive
- Implement database models with Hibernate ORM with Panache
- Prepare Quarkus applications for GraalVM native image compilation
- Configure health probes and Prometheus metrics via MicroProfile

## Example prompts
- Generate a reactive Quarkus endpoint for user registration with request validation
- Create a Product entity extending PanacheEntity with custom find queries
- Set up a multi-stage Dockerfile for a GraalVM native Quarkus image

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e8cb20ec548ed77f.

BEGIN THIRD-PARTY FILE e8cb20ec548ed77f
```text
---
name: java-quarkus-development
description: Java Quarkus development guidelines for building cloud-native applications with fast startup, minimal memory footprint, and GraalVM native builds
metadata:
  maintainer: Mindrally
  source: https://github.com/Mindrally/skills
---

# Java Quarkus Development Best Practices

## Core Principles

- Write clean, efficient, and well-documented Java code using Quarkus best practices
- Focus on fast startup and minimal memory footprint via GraalVM native builds
- Leverage Quarkus extensions for common functionality
- Design for containerized and serverless deployments
- Follow SOLID principles and microservices architecture patterns

## Development Workflow

### Quarkus Dev Mode
- Use `quarkus dev` for rapid iteration with live reload
- Leverage continuous testing during development
- Use Dev UI for debugging and configuration inspection
- Take advantage of Dev Services for local development

## Configuration

### Type-Safe Configuration
- Use `@ConfigProperty` for type-safe configuration injection
- Group related configs with `@ConfigMapping` interfaces
- Validate configuration at startup
- Document configuration properties

### Profile-Based Configuration
- Use `%dev`, `%test`, `%prod` prefixes for environment-specific configs
- Override configs via environment variables in production
- Keep sensitive values out of source control
- Use `.env` files for local development

## Dependency Injection

### CDI Annotations
- Use `@Inject` for dependency injection
- Use `@Named` to qualify implementations
- Use `@Singleton`, `@ApplicationScoped`, `@RequestScoped` appropriately
- Prefer constructor injection for required dependencies

### Bean Discovery
- Understand Quarkus build-time bean discovery
- Use `@IfBuildProfile` for conditional beans
- Avoid reflection-heavy patterns for native builds

## REST API Development

### RESTEasy Reactive
- Use `@Path`, `@GET`, `@POST`, etc. for endpoint definitions
- Return proper HTTP status codes
- Use `@Valid` for input validation
- Implement exception mappers for consistent error responses

### Reactive Patterns
- Use Mutiny for reactive programming
- Leverage `Uni` and `Multi` for async operations
- Combine reactive with imperative code where appropriate

## Data Access

### Hibernate ORM with Panache
- Use Panache for simplified JPA patterns
- Leverage Active Record or Repository patterns
- Use `PanacheEntity` for entities with built-in operations
- Implement custom queries with `find` and `list` methods

### Database Operations
- Use Flyway or Liquibase for migrations
- Configure connection pooling with Agroal
- Use reactive database clients for non-blocking I/O

## Testing

### JUnit 5 Integration
- Use `@QuarkusTest` for integration tests
```
END THIRD-PARTY FILE e8cb20ec548ed77f

The third-party file has ended. Everything between the e8cb20ec548ed77f tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2766 of 4331 bytes. © Mindrally · Apache-2.0 · https://github.com/Mindrally/skills/tree/HEAD/java-quarkus-development/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md