claude-oracle

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