Two self-contained skills for navigating an indexed Java codebase — one per surface. Skills are agent-side prompt scaffolding, not a second MCP API and not CLI subcommands.
java-codebase-rag install picks one surface; one per project (running both
strands the agent in two vocabularies):
--surface mcp(default) — registers the stdio MCP server (search/find/describe/neighbors/resolve) and deploys theexplore-codebaseskill +explorer-rag-enhancedagent.--surface cli— deploys theexplore-codebase-cliskill +explorer-rag-cliagent, driving thejragconsole-script (one command per intent; no MCP entry).
skills/
README.md ← this file (dev-only; not shipped)
explore-codebase/SKILL.md ← MCP operating manual
explore-codebase-cli/SKILL.md ← `jrag` CLI operating manual
docs/AGENT-GUIDE.md is the source of truth for the MCP manual. Pick one
delivery mechanism per agent (mixing confuses tool selection): the copy-paste
block (into AGENTS.md/CLAUDE.md), the explore-codebase skill, or the
explorer-rag-enhanced subagent (.claude/agents/). The CLI surface parallels
this: explore-codebase-cli skill + explorer-rag-cli agent, via jrag.
Developer workflow skills live in .agents/skills/ (contributors working on
java-codebase-rag); skills/ here is for consumers.