claude-oracle
// Automatic tool discovery across 17 sources — hooks search before planning and after errors, siblings avoid redundant searches
$ git log --oneline --stat
stars:290
forks:55
updated:February 22, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameclaude-oracle
descriptionAutomatic tool discovery across 17 sources — hooks search before planning and after errors, siblings avoid redundant searches
triggersPreToolUse,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)
search("query")— search all sources- Review results with install commands
- Install useful tools: skills, plugins, or MCP servers
Discovery (with siblings)
- If historian active:
find_similar_queries("query")first to check if this search was done before search("query")— oracle's own search across 17 sources- If praetorian active: compact the discovery results for future reference
- Present findings with install commands and note what siblings already provide
Error Tool Search (standalone)
- Error triggers PostToolUse hook
search("error description")— find tools that address this error class- Present matching tools with install commands
Error Tool Search (with siblings)
- Error triggers PostToolUse hook
- If historian active:
get_error_solutions("error")checks if solved before search("error description")— oracle finds new tools- If gladiator active: error is also being observed for pattern detection
- 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