claude-oracle
Scannednpx machina-cli add skill Vvkmnn/claude-emporium/claude-oracle --openclawOracle 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
Source
git clone https://github.com/Vvkmnn/claude-emporium/blob/main/plugins/claude-oracle/skills/claude-oracle/SKILL.mdView on GitHub Overview
claude-oracle automatically discovers tools, skills, plugins, and MCP servers by searching 17 sources in parallel. It uses pre-planning and post-error hooks to surface relevant tools and avoids redundant searches through sibling coordination.
How This Skill Works
When PreToolUse(EnterPlanMode) fires, it triggers a search for tools before planning. After errors, PostToolUse(Bash) triggers a search for tools that address the error class. It coordinates with sibling components (Historian, Praetorian, Gladiator) to cache results, deduplicate searches, and detect tool gaps.
When to Use It
- Before planning a task, to surface relevant tools across 17 sources.
- When siblings are active, to reuse cached results and avoid duplicate discovery.
- After an error triggers, to find tools that address the error class via the PostToolUse hook.
- When you want broad coverage by searching 17 sources for skills, plugins, or MCP servers.
- When you want install commands and discoveries presented for quick action.
Quick Start
- Step 1: /search-oracle <query> to search across all 17 sources.
- Step 2: Review results and install useful tools with install commands.
- Step 3: If an error occurs, rely on the PostToolUse hook to surface fixes and install them.
Best Practices
- Use /search-oracle <query> to actively scan all 17 sources.
- Leverage Historian first to skip redundant searches.
- If history is missing, run a fresh discovery and then compact results with Praetorian.
- Review install commands for each found tool and verify compatibility.
- Use Gladiator signals to identify gaps and trigger targeted searches.
Example Use Cases
- Discover a Claude MCP server that matches a task by querying 17 sources.
- Find a relevant plugin or skill across npm, GitHub, and CLAUDE ecosystems.
- Address a runtime error by locating tools designed for that error class.
- Cache and reuse prior searches when historians indicate a similar query exists.
- Detect tool gaps with Gladiator and perform a new discovery cycle.
