claude-oracle — Claude Code skill: tool discovery
claude-oracle searches 17 sources for relevant skills, plugins, and MCP servers. It runs before planning and after Bash errors.
MIT ★ 78 updated 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-oracle@claude-emporiumWhat claude-oracle does
Before Claude Code enters planning mode, a hook searches for tools related to the task. A Bash error triggers another search for tools that could address it. Results include installation commands.
For a manual lookup, use /search-oracle <query> [type]. The skill searches sources in parallel, including Smithery Registry, Glama.ai, Official MCP Registry, npm, and GitHub marketplace plugins. It requires the MCP server to be added with claude mcp add oracle -- npx claude-oracle-mcp.
When Historian is active, Oracle can check earlier searches or error fixes before looking again. Praetorian can retain earlier findings, while Gladiator tracks errors. Oracle will not run until its MCP server is added.
What it helps with
- find skills relevant to a task before planning
- search for tools that address a Bash error
- check whether similar tools were found earlier
- get install commands for matching tools
Example prompts for the agent
- Find MCP servers for working with PostgreSQL.
- Look for tools that could fix this Bash error.
- Find skills for generating PDFs.
How to install claude-oracle
1Plugin marketplace
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-oracle@claude-emporiumThis installs the whole claude-oracle plugin with all its skills
2Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-oracle -a claude-code3Manually: put the files in place
~/.claude/skills/claude-oracle/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/claude-oracle/
1Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-oracle -a codex2Manually: put the files in place
.agents/skills/claude-oracle/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-oracle -a cursor2Manually: put the files in place
.cursor/skills/claude-oracle/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Vvkmnn/claude-emporium plugins/claude-oracle/skills/claude-oracle2Manually: put the files in place
.github/skills/claude-oracle/SKILL.md1Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-oracle -a gemini-cli2Platform CLI
gemini skills install https://github.com/Vvkmnn/claude-emporium --path plugins/claude-oracle/skills/claude-oracleManually: put the files in place
.devin/skills/claude-oracle/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about claude-oracle
How do I install claude-oracle in Claude Code?
Run /plugin marketplace add Vvkmnn/claude-emporium, then run /plugin install claude-oracle@claude-emporium. Keep this order.
What does claude-oracle do?
It searches 17 sources for skills, plugins, and MCP servers. Hooks trigger searches before planning and after Bash errors.
What does claude-oracle need to run?
Add its MCP server with claude mcp add oracle -- npx claude-oracle-mcp. Manual searches use /search-oracle <query> [type].
Source text
SKILL.md · MIT
---
name: claude-oracle
description: Automatic tool discovery across 17 sources — hooks search before planning and after errors, siblings avoid redundant searches
triggers: [PreToolUse, PostToolUse]
---
# Oracle Plugin
Tool discovery. Searches 17 sources in parallel to find relevant skills, plugins, and MCP servers.
## Hooks
| Hook | When | Action |
|------|------|--------|
| **PreToolUse(EnterPlanMode)** | Before planning | Searches for relevant tools before planning |
| **PostToolUse(Bash)** | After errors | Searches for tools that solve the error |
## Commands
| Command | Description |
|---------|-------------|
| `/search-oracle <query> [type]` | Search for tools across all 17 sources |
## Workflows
### Discovery (standalone)
1. `search("query")` — search all sources
2. Review results with install commands
3. Install useful tools: skills, plugins, or MCP servers
### Discovery (with siblings)
1. If **historian** active: `find_similar_queries("query")` first to check if this search was done before
2. `search("query")` — oracle's own search across 17 sources
3. If **praetorian** active: compact the discovery results for future reference
4. Present findings with install commands and note what siblings already provide
### Error Tool Search (standalone)
1. Error triggers PostToolUse hook
2. `search("error description")` — find tools that address this error class
3. Present matching tools with install commands
### Error Tool Search (with siblings)
1. Error triggers PostToolUse hook
2. If **historian** active: `get_error_solutions("error")` checks if solved before
3. `search("error description")` — oracle finds new tools
4. If **gladiator** active: error is also being observed for pattern detection
5. Combined: past solution (historian) + new tools (oracle) + pattern tracking (gladiator)
## Sibling Synergy
| Sibling | Value | How |
|---------|-------|-----|
| **Historian** | Past searches avoid duplicate discovery | Historian checked first, oracle only runs if no history match |
| **Praetorian** | Cached compactions contain prior tool results | Restore before re-searching |
| **Gladiator** | Observations reveal tool gaps | Reflection may suggest searching for tools to fill gaps |
## Data Sources (17)
Smithery Registry, Glama.ai, Official MCP Registry, npm, GitHub marketplace plugins, awesome-mcp-servers, awesome-mcp-lists, awesome-claude-code (ccplugins), awesome-claude-code (jmanhype), awesome-agent-skills, Playbooks.com, SkillsMP, and more.
## Requires
```
claude mcp add oracle -- npx claude-oracle-mcp
```
© vvkmnn · MIT · Vvkmnn/claude-emporium