Skip to content

Maven repositories + improved SKILL.md - #121

Open
matejcerny wants to merge 1 commit into
VirtusLab:mainfrom
matejcerny:maven-config
Open

Maven repositories + improved SKILL.md#121
matejcerny wants to merge 1 commit into
VirtusLab:mainfrom
matejcerny:maven-config

Conversation

@matejcerny

@matejcerny matejcerny commented Aug 9, 2026

Copy link
Copy Markdown
Contributor
  • add support for configuring extra Maven repositories
  • rewrite SKILL.md to be more concise / token efficient

(I've been using this updated skill for more than a week, so I can confirm it works correctly)

@rochala

rochala commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

LGTM but before I merge I want to run skill creator skill to double check those changes

@rochala

rochala commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Skill creator suggested leaving example block because it tell agent how it can grep it further etc.

Comment thread skills/cellar/SKILL.md

Run `cellar --version` to verify cellar is on PATH. If not found, the user
needs to install it: https://github.com/VirtusLab/cellar#installation
Look up JVM dependency APIs from the terminal. NEVER download or unpack JARs manually.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Skill-creator suggested that leaving a reason will hold better and have better results

Comment thread skills/cellar/SKILL.md
Prefer cellar **only** for external dependency API lookups (`cellar get-external` vs Metals `inspect`/`get-docs`): cellar requires no project import and works with any published Maven coordinate. For all other tasks — goto definition, find references, rename, diagnostics, compilation — use Metals.
cellar reads APIs, nothing else.
External coordinate → cellar.
Project classpath → Metals `inspect`/`get-docs`/`glob-search`, or cellar's project-aware commands when Metals is unavailable.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have to be extra careful with metals.

I got some comments / feedback that when they used it with IJ, it tried to install metals or something because of our skill. I'd be very explicit here so something more like:

Project classpath:
Metals MCP server if available > cellar project-aware commands

Compile, references, tests, formatting are not supported by cellar

rochala added a commit that referenced this pull request Aug 23, 2026
`MavenRepository.of` accepts any string verbatim, so a typo like a
missing scheme survived until resolution failed — and it then failed as
`CoordinateNotFound`, pointing at the coordinate with coordinate
suggestions rather than at the repository that was actually wrong.

Reject the URL at parse time instead: empty strings, unparseable URIs,
a missing scheme, schemes other than http/https/file, and http(s) URLs
with no host. The rejection reason carries no source prefix of its own,
so the caller names where the URL came from; that keeps the config-file
source #121 adds able to reuse the same check.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants