Skip to main content
skill CX Codex

claude-oracle — Claude Code skill: tool discovery

claude-oracle searches 17 sources for relevant skills, plugins, and MCP servers. It runs before planning and after Bash errors.

MIT ★ 78 updated 2026-03-05

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-oracle@claude-emporium
Open on GitHub

What claude-oracle does

Before Claude Code enters planning mode, a hook searches for tools related to the task. A Bash error triggers another search for tools that could address it. Results include installation commands.

For a manual lookup, use /search-oracle <query> [type]. The skill searches sources in parallel, including Smithery Registry, Glama.ai, Official MCP Registry, npm, and GitHub marketplace plugins. It requires the MCP server to be added with claude mcp add oracle -- npx claude-oracle-mcp.

When Historian is active, Oracle can check earlier searches or error fixes before looking again. Praetorian can retain earlier findings, while Gladiator tracks errors. Oracle will not run until its MCP server is added.

What it helps with

  • find skills relevant to a task before planning
  • search for tools that address a Bash error
  • check whether similar tools were found earlier
  • get install commands for matching tools

Example prompts for the agent

  • Find MCP servers for working with PostgreSQL.
  • Look for tools that could fix this Bash error.
  • Find skills for generating PDFs.

How to install claude-oracle

1Plugin marketplace

/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-oracle@claude-emporium

This installs the whole claude-oracle plugin with all its skills

2Skills CLI (Vercel)

npx skills add Vvkmnn/claude-emporium --skill claude-oracle -a claude-code

3Manually: put the files in place

~/.claude/skills/claude-oracle/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/claude-oracle/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about claude-oracle

How do I install claude-oracle in Claude Code?

Run /plugin marketplace add Vvkmnn/claude-emporium, then run /plugin install claude-oracle@claude-emporium. Keep this order.

What does claude-oracle do?

It searches 17 sources for skills, plugins, and MCP servers. Hooks trigger searches before planning and after Bash errors.

What does claude-oracle need to run?

Add its MCP server with claude mcp add oracle -- npx claude-oracle-mcp. Manual searches use /search-oracle <query> [type].

Source text

SKILL.md · MIT
---
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
```

© vvkmnn · MIT · Vvkmnn/claude-emporium

Similar skills

All skills for Data and databases →
rds-oracle aws rds-oracle troubleshoots Amazon RDS for Oracle connectivity, authentication, networking and driver failures. Use it for EC2, EKS, Lambda or Oracle client connection issues. CX Codex +1 5,300installs reviewing-oracle-to-postgres-migration official github reviewing-oracle-to-postgres-migration reviews Oracle-to-PostgreSQL migration risks and checks whether migration artifacts and integration tests cover the relevant behavior changes. CX Codex +1 1,800installs planning-oracle-to-postgres-migration-integration-testing official github planning-oracle-to-postgres-migration-integration-testing is a GitHub Copilot skill that plans integration tests for .NET projects moving from Oracle to PostgreSQL. It finds database access points and ranks them by migration risk. CX Codex +1 1,800installs oracle-fusion-recruiting-cloud membrane This skill connects an agent to Oracle Fusion Recruiting Cloud through the Membrane CLI. Use it to discover and run actions on recruiting records, or send API requests through Membrane’s proxy. CX Codex +1 186installs oracle-ai-data-platform-workbench-engineer-agent Oracle oracle-ai-data-platform-workbench-engineer-agent — a 37-skill agent for Oracle AI Data Platform Workbench: catalog discovery, Spark SQL, pipelines, governance and Delta Sharing, all driven by plain English. ★ 62repo stars mtg-oracle gregario mtg-oracle is a Claude Code MCP server that supplies card lookups, comprehensive Magic: The Gathering rules, format legality checks, and deck analysis tools. CX Codex +1 ★ 6repo stars

From the same set20

The whole set →
search-oracle search-oracle searches across 17 sources for skills, plugins, and MCP servers. Useful when you need to discover and install new tooling directly inside Claude Code. CX Codex +1 ★ 78repo stars restore-praetorian restore-praetorian is a Claude Code command that retrieves past work from praetorian memory. It helps resume tasks by finding recent summaries or searching saved session context. CX Codex +1 ★ 78repo stars compact-praetorian compact-praetorian — a Claude Code command that writes the current session context into praetorian memory so it persists across sessions. Trigger it after research, exploration, or any decision worth keeping. CX Codex +1 ★ 78repo stars review-gladiator review-gladiator processes recorded observations across sessions, clusters recurring patterns, and suggests actionable workflow rules. CX Codex +1 ★ 78repo stars claude-praetorian claude-praetorian — a skill that snapshots your context before it gets compacted and brings it back later: before planning, after web research, when a subagent finishes. CX Codex +1 ★ 78repo stars claude-vigil claude-vigil saves file checkpoints and automatically quicksaves code before risky bash operations like rm or git reset. Roll back edits whenever an agent command goes wrong. CX Codex +1 ★ 78repo stars claude-orator claude-orator scores prompts across seven dimensions and returns a reworked version. Use it to shape subagent requests or review prompts across a session. CX Codex +1 ★ 78repo stars claude-historian claude-historian — a skill that automatically searches past sessions before triggering web research, planning, or debugging. Reuse past solutions across projects and avoid redundant work. CX Codex +1 ★ 78repo stars

Project sponsors

Companies that keep this analytics open