claude-oracle

star 84

Automatic tool discovery across 17 sources — hooks search before planning and after errors, siblings avoid redundant searches

Vvkmnn By Vvkmnn schedule Updated 2/20/2026

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
Install via CLI
npx skills add https://github.com/Vvkmnn/claude-emporium --skill claude-oracle
Repository Details
star Stars 84
call_split Forks 4
navigation Branch main
article Path SKILL.md
More from Creator