claude-oracle

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