Add extension skills, server instructions, and CLAUDE.md generation#4
Merged
phillip-kruger merged 1 commit intoquarkusio:mainfrom Mar 26, 2026
Merged
Conversation
4058541 to
047ed7d
Compare
- SkillReader: reads extension skills from the aggregated
quarkus-extension-skills JAR instead of per-extension deployment JARs.
Auto-downloads from Maven repos if not in local .m2, respecting
mirrors from ~/.m2/settings.xml, ${MAVEN_HOME}/conf/settings.xml,
and .mvn/maven.config.
- Server instructions: configures quarkus.mcp.server.server-info.instructions
to direct AI agents to use quarkus-agent tools (skills, searchDocs,
callTool) over generic alternatives like Context7.
- CLAUDE.md generation: quarkus/create now generates a CLAUDE.md in every
new project with Quarkus-specific workflow rules, including running
tests via subagents for non-blocking test execution.
- DevMcpProxyTools: quarkus/skills tool updated to use the new
SkillReader that reads from the single aggregated JAR.
Depends on:
- quarkusio/quarkus#53195 (aggregate-skills mechanism)
- quarkusio/quarkus#53196 (extension skill files)
- quarkusio/quarkus#53182 (one-shot testing)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
047ed7d to
3ee521b
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds extension skill support, MCP server instructions, project-level CLAUDE.md generation, and a
quarkus/updatetool to improve how AI coding agents work with Quarkus projects.Extension Skills (
SkillReader)quarkus-extension-skillsJAR (one JAR per Quarkus version containing all composedSKILL.mdfiles).m2.mvn/maven.config(project-level custom settings file via-s)~/.m2/settings.xml(user-level mirrors)${MAVEN_HOME}/conf/settings.xml(global mirrors)mirrorOfpatterns:central,*,external:*, comma-separated,!centralexclusionsUpdate Tool (
quarkus/update)New tool that checks if a Quarkus project is up-to-date and provides a unified upgrade report:
quarkus update --dry-run(if CLI is available) to preview automated migrations and patchesBased on the quarkus-update skill.
MCP Server Instructions
Configures
quarkus.mcp.server.server-info.instructionsto direct AI agents to:quarkus/update(via subagent) when starting work on existing projectsquarkus/skillsbefore writing any code (extension-specific patterns and pitfalls)quarkus/searchDocsover generic documentation tools (Context7, web search)quarkus/callToolfor testing via subagentsCLAUDE.md Generation
quarkus/createnow generates aCLAUDE.mdin every new project with:Other Improvements
-Dquarkus.dev-mcp.enabled=true) when starting appsDepends on (Quarkus core PRs)