Repository navigation
feat(skill): add a Solr Agent Skill for the server's tools - #281
Open
adityamparikh wants to merge 2 commits into
Open
adityamparikh wants to merge 2 commits into
adityamparikh wants to merge 2 commits into
Conversation
Add src/main/resources/skills/solr/ as an Agent Skills directory: SKILL.md plus references on indexing behaviour, the server's error messages, and Solr version differences seen through the tools. The skill covers this server, not Solr itself; the Solr Reference Guide covers that. SolrSkillFormatTest enforces the Agent Skills format and the SEP-2640 size limits so a malformed skill fails the build. Serving the skill over MCP is tracked separately in apache#280. Closes apache#279 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Aditya Parikh <aditya.m.parikh@gmail.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Signed-off-by: Aditya Parikh <aditya.m.parikh@gmail.com>
|
5 tasks
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.
Closes #279
What
Adds
src/main/resources/skills/solr/, an Agent Skill about this server's tools:SKILL.md: which tool does what, and what to know before writing data (collections created with defaults share the_defaultconfigset, document ids and re-sending, how field names and values are stored, commits).references/indexing.md: what eachindex-*tool does to the data, how responses read, partial failures.references/troubleshooting.md: the server's error messages, what each means, the next call.references/solr-versions.md: what differs across Solr 9.4 to 10 as seen through the tools.README,
docs/FAQ.mdandAGENTS.mddescribe the skill. The FAQ's "thin skill for query and faceting know-how" now reads as server-specific guidance.Why
The tools give an agent safe operations but not the behaviour behind them: ids that decide whether a re-send duplicates, a schema shared across collections, a response that does not say which documents failed. The skill holds that. It does not teach Solr itself; query syntax, analyzers and schema design are Solr Reference Guide material, which an LLM can reach through its own knowledge, web search or a docs-lookup tool.
It also avoids restating the tool descriptions, prompts and server instructions, so the prompts are unchanged.
Tests
SolrSkillFormatTestparses the frontmatter and checks the Agent Skills rules (allowed keys,nameequals the directory, description at most 1024 characters,metadatais string to string),SKILL.mdunder 500 lines and about 5000 tokens, every reference named inSKILL.md, every relative link resolving, noscripts/, and the SEP-2640 limits of 512 files and 16 MiB.The claims about ids, generated ids on re-send and array-valued guessed fields were checked against a Solr 9.9 container.
./gradlew buildpasses: 471 tests, 0 failures, 0 skipped.Serving the skill to clients over MCP is #280.
🤖 Generated with Claude Code