Claude-emporium claude-oracle

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

install

source · Clone the upstream repo

git clone https://github.com/Vvkmnn/claude-emporium

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Vvkmnn/claude-emporium "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/claude-oracle/skills/claude-oracle" ~/.claude/skills/vvkmnn-claude-emporium-claude-oracle && rm -rf "$T"

manifest: plugins/claude-oracle/skills/claude-oracle/SKILL.md

source content

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