Agent skill

claude-oracle

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

Stars 113
Forks 5

Install this agent skill to your Project

npx add-skill https://github.com/Vvkmnn/claude-emporium/tree/main/plugins/claude-oracle/skills/claude-oracle

SKILL.md

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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results