Skip to content
Get packs

Guide · Agent skill

How to use the Quarkus TDD Workflow agent skill (quarkus-tdd)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The quarkus-tdd skill is a set of instructions, with code examples, that tells an AI coding agent how to work test-first on Quarkus 3.x Java services. It is aimed at event-driven back ends that use Apache Camel and RabbitMQ. After this guide you will know how to install the skill, how to ask for it in plain language, and what the agent will and will not do with it.

Quarkus TDD Workflowaffaan-m/ECC · MIT

Quick start

  1. 1Download the ZIP. Get the quarkus-tdd ZIP from this page. It contains SKILL.md.
  2. 2Unzip into a skills folder. Place the quarkus-tdd folder in ~/.claude/skills/ for personal use, or in .claude/skills/ in your project.
  3. 3Or upload it in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill.
  4. 4Make sure your stack matches. Confirm the project uses Java, Quarkus 3.x, JUnit 5, Mockito, REST Assured, Apache Camel and JaCoCo.
  5. 5Describe the task in plain language. Ask for a feature, bug fix or refactor and say that tests should come first.
  6. 6Verify the result. Check that the failing tests came first, all tests pass, and JaCoCo reports 80% or more.

What the quarkus-tdd skill makes the agent do

An agent skill is a folder with a SKILL.md file that gives an AI agent extra guidance for a specific kind of task. When this skill is active, the agent follows a fixed test-driven routine: write tests first and make sure they fail, write the minimum code needed to pass them, then refactor while the tests stay green, and finally require JaCoCo coverage of 80% or more.

The skill's examples use JUnit 5, Mockito, REST Assured and Camel route tests with @QuarkusTest. Test classes group tests with @Nested and @DisplayName, and test names follow the pattern givenX_whenY_thenZ. Each test is split into // ARRANGE, // ACT and // ASSERT sections.

  • Use it for new features or REST endpoints, bug fixes and refactoring.
  • Use it for Apache Camel routes, event handlers and RabbitMQ-based services.
  • Use it for conditional flow logic and CompletableFuture operations, and for LogContext propagation.

Install the quarkus-tdd skill from the ZIP download

Download the ZIP for the quarkus-tdd skill from this page. The package contains SKILL.md, the only file listed for this skill. Unzip it so that the quarkus-tdd folder ends up in one of two places: ~/.claude/skills/ for personal use across projects, or .claude/skills/ inside a specific project if you want it only for that project.

If you use the Claude apps instead, you can upload the skill under Settings → Capabilities → Skills.

  • Personal install: place the folder in ~/.claude/skills/.
  • Project install: place the folder in .claude/skills/ at the project root.
  • Claude apps: upload the skill under Settings → Capabilities → Skills.

Trigger the skill with natural requests

You do not need a special command. Describe the task in plain language and mention the kind of work involved. The skill's description covers adding features, fixing bugs and refactoring event-driven services, so requests that name those tasks are the most likely to activate it.

Name the Quarkus and Java context too. A request such as 'add a POST endpoint to the order service in this Quarkus project, tests first' gives the agent enough to match the skill's stack.

  • Add a feature: "Add a REST endpoint that creates orders in this Quarkus service. Write the tests first and make them fail before you implement."
  • Fix a bug: "Fix the duplicate-event bug in the RabbitMQ consumer, starting with a failing test."
  • Refactor: "Refactor OrderService using TDD and keep JaCoCo coverage at 80% or more."

Read the examples the skill provides

The skill includes two complete Java examples. The first is a unit test for an OrderService class using @ExtendWith(MockitoExtension.class), @Mock, @InjectMocks and @BeforeEach, with tests for successful creation, rejection of an empty customer id (expecting a 400 status), and recording an error event when persistence fails. The second is a Camel route test that uses @QuarkusTest, @Inject for CamelContext and ProducerTemplate, and AdviceWith to replace a RabbitMQ endpoint with a mock.

The skill also has an EventService test example that shows assertDoesNotThrow for success cases and assertThrows with message checks for failures. Use these as patterns for the agent to follow, and check that they match your own class names and packages.

Check the output against the test-first routine

Because the skill only gives guidance, you are the check. Ask the agent to show the failing test before the implementation, then confirm the tests pass and that JaCoCo reports coverage of 80% or more. Read the tests themselves: a test that asserts nothing or mocks away the behaviour you care about will still pass.

  • Ask for the failing test output before any production code.
  • Run your build and JaCoCo report yourself.
  • Review verify() and never() checks for error paths.

What people use it for

  • Adding a REST endpoint to a Quarkus service with tests written before the code.
  • Fixing a bug in a RabbitMQ consumer by first writing a test that reproduces it.
  • Testing a Camel route by replacing its RabbitMQ endpoint with a mock endpoint.
  • Refactoring an event service while keeping the test suite green.
  • Writing Mockito unit tests that check error events are recorded when persistence fails.

Frequently asked questions

How do I install the quarkus-tdd agent skill?

Download the ZIP from this page and unzip it so the quarkus-tdd folder sits in ~/.claude/skills/ for personal use, or in .claude/skills/ inside a project. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.

What do I need to use the quarkus-tdd skill?

The skill targets Java with Quarkus 3.x, and its examples use JUnit 5, Mockito, REST Assured, Apache Camel and JaCoCo. If your project does not use these, the examples will not apply directly.

Is the quarkus-tdd skill free?

The skill is listed under the MIT licence. This page does not state any price, so check the licence terms in the source repository for details of use.

Does the skill run scripts or access the network?

No. The skill runs no scripts and uses no network access. It consists of a single SKILL.md file with guidance and examples.

Does the skill check or verify the code it writes?

No. It only gives the agent guidance and examples. You still need to run your tests and JaCoCo report to confirm the code works and meets coverage.

Is there an alternative if my project does not use Quarkus?

Yes. Because the examples and annotations are Quarkus-specific, a project on another Java framework or a different language will need a different skill or manual guidance. This skill is a poor fit for those stacks.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use quarkus-tdd if you build Quarkus 3.x Java services with Apache Camel and RabbitMQ and want the agent to write tests first, with Spanish-language examples. Skip it if your project does not use Quarkus or Java, or if you want a general introduction to TDD, since the file is specific to Quarkus test tooling and gives guidance rather than automated checks.

Download the skill