---
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
```