skills.md for quarkus?

[William Burke]

Anybody happen to be working on skills.md files for quarkus?

--

Bill Burke

IBM

[Georgios Andrianakis]

See https://github.com/quarkusio/quarkus/tree/main/.agents%2Fskills

--
You received this message because you are subscribed to the Google Groups "Quarkus Development mailing list" group.
To unsubscribe from this group and stop receiving emails from it, send an email to quarkus-dev...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/CAL%3DE%3DjQtc0iT4UPw188RnyTNhYYKhCjq5FzpYwFxtF2oBShR4w%40mail.gmail.com.

[Paul Robinson]

Bill,

Do you mean for developing Quarkus apps or for developing the Quarkus project itself?

Paul.

On 17 Apr 2026, at 5:54 pm, 'Georgios Andrianakis' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:



To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/CALeTM-nFCxZ9ObjVxdB0ioNoWpQvVpzqXWOpWhN5wkNidWTDPw%40mail.gmail.com.

[Guillaume Smet]

From my experience today, I think we need to be extremely careful in what we add to skills and AGENTS.md.

We should guide Claude when he's confused or not efficient, but some things we added to AGENTS.md actually made things worse today, with Claude using `-Dno-format` for building and then fixing import order and formatting issues one by one.

It never did that before we told him about `-Dno-format` in the AGENTS.md.

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/AB22C64F-1FCE-4851-BAF3-8BF8885BB1C6%40redhat.com.

[Marco Bungart]

Just to underline Guillaume's Argument:

"... Across multiple coding agents and LLMs, we find that context files tend to reduce task success rates compared to providing no repository context, while also increasing inference cost by over 20%. ..." [1]

[1]: https://arxiv.org/abs/2602.11988

- Marco

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/CALt0%2Bo_0ybqw_AQzuLjnVsr%3Dv%2BJVoNAyxw8wxjZJmefdKa1wsQ%40mail.gmail.com.

[William Burke]

@Paul and @Guillaume Smet 

Looking for SKILLS.md for developing Quarkus apps.  If I say "Lets spec out a Quarkus chat app", I want it to set up the pom correctly, chose my new Chat Scopes project.  Build the UI correctly, etc.  I have yet to have good experiences with codeless app development like some of you all have and I want to figure out why.

@Marco Still, I want to see if I can at least point claude to use the appropriate libraries and extensions.

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/5d97e7ad-ef02-490e-87ce-a687df22c498%40googlemail.com.

--

Bill Burke

IBM

[Paul Robinson]

This is what I’m looking forward to trying too :-)

I think Phillip said he planned to have a basic Skill ready to try next week.

On 17 Apr 2026, at 8:03 pm, 'William Burke' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:



To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/CAL%3DE%3DjQ9AtkgvcpMey5URfFzB%3D2093P-QF7oVJEVBEFa9EydZg%40mail.gmail.com.

[Sergey Beryozkin]

That should probably be a different standalone project, perhaps a subproject of Quarkus LangChain4j

where a Quarkus centric assistant experience for creating Quarkus applications is provided.

Sergey

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/AA095028-01A2-4048-B921-985A063B2E45%40redhat.com.

[Max Rydahl Andersen]

Skills isn’t about quarkus Langchain4j so not the right place imo. 

What Phillips demoed at community call was dev star - which includes the work started on enabling extensions to optional provide skills related to them but we also have quarkusio/quarkus-skills for more general/cross cutting stuff. 

This is part of the dev star working group activities. 

Sent from my iPhone

On 18 Apr 2026, at 13:41, 'Sergey Beryozkin' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:



To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/CAMsYBfWnuUqWmC%3DB9fLu99bXof8DeufypA%3Dt6qF2c%2BLw4D3Hsg%40mail.gmail.com.

[Max Rydahl Andersen]

Yes. Skills aren’t to be interjected into agents.md. Unless truly crucial. 

Guillaume and I opened prs to fix the current bugs in our agents.md. 

When they are merged we really should only add stuff when we find the good models struggle with something. 

Adding stuff upfront rarely is worth it imo. 

Need to be deliberate. 

/max

Sent from my iPhone

On 17 Apr 2026, at 19:52, 'Marco Bungart' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:



To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/5d97e7ad-ef02-490e-87ce-a687df22c498%40googlemail.com.

<OpenPGP_0x1D62FE7F6FECFBC5.asc>

[Sergey Beryozkin]

On Sat, Apr 18, 2026 at 1:48 PM 'Max Rydahl Andersen' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:

Skills isn’t about quarkus Langchain4j so not the right place imo. 

What Phillips demoed at community call was dev star - which includes the work started on enabling extensions to optional provide skills related to them but we also have quarkusio/quarkus-skills for more general/cross cutting stuff. 

This is part of the dev star working group activities. not 

This is all great, yes, but I do think there is a scope for creating dedicated assistants with trained models and a set of skills for Quarkus-centric application development,

not in Claude/Cursor but with a Quarkus-branded assistant

Sergey

 

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/610ED29B-96C2-44EC-9A39-D044E5520D4C%40redhat.com.

[Max Rydahl Andersen]

Training models ? I doubt that is a good return of investment given how easy it is to guide modern models. 

What do you feel the models will benefit to get trainings on?

With respect to quarkus branded agents - that is what chappie is. 

/max

Sent from my iPhone

On 18 Apr 2026, at 20:53, 'Sergey Beryozkin' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:



To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/CAMsYBfV%2BkZ7d7dASriaV7pKkYRsV_BDUEzGCGX6K0MaK0fZ-JQ%40mail.gmail.com.

[Sergey Beryozkin]

On Sat, Apr 18, 2026 at 8:34 PM 'Max Rydahl Andersen' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:

Training models ? I doubt that is a good return of investment given how easy it is to guide modern models. 

What do you feel the models will benefit to get trainings on?

Yes, you are right, skills is a more effective method. 

I don't know if a dedicated model training can bring some extra finesse, it may become more obvious in a medium term  

With respect to quarkus branded agents - that is what chappie is. 

Sure, it is nice, I'm excited as everyone else about the fusion of the Quarkus Dev and AI. 

I'm thinking about us shipping a project where users start an assistant, and tell it to create some Quarkus application meeting some spec,

the assistant goes ahead, and creates what is required using a curated list of supported extensions, It feels a higher level kind of task.

Users who work with this assistant may not be even actual developers...

In any case, I don't mean to hijack the discussion about skills

Cheers, Sergey

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/00B9CD92-F043-4A36-83C0-E59AFE173407%40redhat.com.

[William Burke]

On Sat, Apr 18, 2026 at 4:39 PM 'Sergey Beryozkin' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:

On Sat, Apr 18, 2026 at 8:34 PM 'Max Rydahl Andersen' via Quarkus Development mailing list <quark...@googlegroups.com> wrote:

Training models ? I doubt that is a good return of investment given how easy it is to guide modern models. 

What do you feel the models will benefit to get trainings on?

Yes, you are right, skills is a more effective method. 

I don't know if a dedicated model training can bring some extra finesse, it may become more obvious in a medium term  

With respect to quarkus branded agents - that is what chappie is. 

Sure, it is nice, I'm excited as everyone else about the fusion of the Quarkus Dev and AI. 

I'm thinking about us shipping a project where users start an assistant, and tell it to create some Quarkus application meeting some spec,

the assistant goes ahead, and creates what is required using a curated list of supported extensions, It feels a higher level kind of task.

Users who work with this assistant may not be even actual developers...

In any case, I don't mean to hijack the discussion about skills

Creating a Quarkus is exactly what I want to test out and improve.  I'm about to write a "real" Quarkus app and want claude to do it. 

--

Bill Burke

IBM

[Phillip Krüger]

Hey Bill,
This is exactly what I've been working on with quarkus-agent-mcp (https://github.com/quarkusio/quarkus-agent-mcp), a standalone MCP server that gives AI agents (Claude Code, Copilot, Cursor, etc.) first-class Quarkus development support.                                                                                                                                                        
                                                                                                                                                                             
 It already covers the things you're after:                                                                                                                                  
                                                                                                                                                                             
 - Project creation (quarkus/create): scaffolds a Quarkus app with the right extensions and auto-starts dev mode                                                            
 - Extension skills (quarkus/skills): a three-layer skill chain (JAR defaults → user-level → project-level) that teaches agents the correct patterns, testing approaches,    
 and common pitfalls for each extension. So the agent knows how to use Panache, RESTEasy, etc. before writing a single line of code.                                          
 - Semantic doc search (quarkus/searchDocs): agents can search the Quarkus docs contextually instead of hallucinating APIs                                                  
 - Dev MCP proxy: agents can run tests, add extensions, check config, and inspect exceptions on the running app                                                              
                                                                                                                                                                             
The key workflow is: create → load skills → write code → test,  all without the agent needing to know Maven commands or Quarkus internals.

I will release the mcp server hopefully this week some time, but you can build it locally and add the mcp server pointing to your local jar.

You can also watch https://youtu.be/p-dvcjfP8qM?si=AcZKu7hlEqQOdeiW where I discuss this work

Any feedback welcomed :)

[William Burke]

I'm motivated by something Max said at the F2F. (Paraphrasing) "LLMs like abstractions, so if we keep creating and making Quarkus better, the LLMs willget better".  Right now, Quarkus has a few advantages over Spring:  Memory usage, throughput, boot time, developer productivity (joy).  Imagine if we could add: "It cuts claude code tokens by 30% compared to Spring, Python, Go, etc...."

--

You received this message because you are subscribed to the Google Groups "Quarkus Development mailing list" group.
To unsubscribe from this group and stop receiving emails from it, send an email to quarkus-dev...@googlegroups.com.

To view this discussion visit https://groups.google.com/d/msgid/quarkus-dev/9f809785-3525-4088-bdb0-196b77b8696fn%40googlegroups.com.

--

Bill Burke

IBM

[Phillip Krüger]

Hey Bill.

Yes that is definitely one of the goals of the quarkus-agent-mcp. You can start playing with the quarkus-agent-mcp: 

`claude mcp add quarkus-agent -- jbang quarkus-agent-mcp@quarkusio`

At this point, the skills are only in 3.35.x + , So when you create an app, tell it to use 3.35.0.CR1 and see how it goes. You can also tell the agent to create/override/enhance a skill, since there are many extensions that does not yet have a base skill.

Any feedback welcomed :)

Phillip