Skip to main content
skill CX Codex

oma-search · first-fluke, oma — Claude Code skill: search routing

The oma-search skill picks a search channel for docs, web research, code, or local project files, then labels external sources by domain trust. Use it when the right place to search is unclear.

MIT ★ 1,472 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Open on GitHub

What oma-search does

oma-search classifies a request and sends it to Context7 for documentation, runtime web search, gh search code or glab api for code, or Serena for local files. It ranks the results and adds domain trust labels to external sources. One request gets one main route unless ambiguity or flags call for another.

Flags such as --docs, --code, --web, --strict, --wide, and --gitlab take precedence over intent classification. A failed docs search falls back to web; a query about local files goes to Serena instead. The docs route requires Context7 MCP, while code search relies on gh or glab, so the selected route depends on those tools being available.

What it helps with

  • find official library documentation
  • search GitHub or GitLab for code patterns
  • gather web sources for a technical question
  • locate files or symbols in a project

Example prompts for the agent

  • Find Next.js middleware documentation with oma-search --docs.
  • Search GitHub for PKCE implementation patterns using oma-search --code.
  • Look up where this project handles file search with oma-search.

How to install oma-search

1Plugin marketplace

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

This installs the whole oma plugin with all its skills

2Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-search -a claude-code

3Manually: put the files in place

~/.claude/skills/oma-search/SKILL.md

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

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

Questions about oma-search

How do I install oma-search in Claude Code?

Run /plugin marketplace add first-fluke/oh-my-agent, then /plugin install oma@oh-my-agent. As an alternative, run npx skills add first-fluke/oh-my-agent --skill oma-search -a claude-code.

What does oma-search do?

It classifies a search request and routes it to documentation, web, code, or local project search. Results are ranked and external domains receive trust labels.

How does oma-search search local project files?

For queries limited to local files, it uses Serena MCP rather than web search. Documentation searches go through Context7 MCP.

Source text

SKILL.md · MIT
---
name: oma-search
description: Intent-based search router with trust scoring. Routes queries to optimal channels (Context7 docs, native web search, gh/glab code search, Serena local) and attaches domain trust labels. Use for search, find, lookup, reference, docs, code search, and web research.
---

# Search Agent - Intent-Based Search Router

## Scheduling

### Goal
Classify information-seeking requests, route them to the best search channel, attach trust labels, and return source-grounded results.

### Intent signature
- User asks to search, find, look up, reference docs, inspect official documentation, search GitHub/GitLab code, or gather web research.
- Another skill needs reusable search infrastructure with trust scoring.

### When to use
- Finding official library/framework documentation
- Web research for tutorials, examples, comparisons, and solutions
- Searching GitHub/GitLab code for implementation patterns
- Any query where the search channel is unclear (auto-routing)
- Other skills needing search infrastructure (shared invocation)

### When NOT to use
- Local codebase exploration only -> use Serena MCP directly
- Git history or blame analysis -> use SCM Agent
- Full architecture research -> use Architecture Agent (may invoke this skill internally)

### Expected inputs
- Query string, intent hint, or explicit flags such as `--docs`, `--code`, `--web`, `--strict`, `--wide`, `--gitlab`
- Optional required source type, recency, domain, or trust constraints

### Expected outputs
- Ranked search results with route, source, trust label, and concise relevance summary
- Fallback explanation when primary route fails
- Source links or references suitable for the calling skill

### Dependencies
- Context7 MCP for docs, runtime-native web search, `gh`/`glab` for code, Serena for local search
- `resources/intent-rules.md`, `resources/trust-registry.md`, execution protocol, examples, and checklist

### Control-flow features
- Branches by classified intent, user flags, route success/failure, and trust constraints
- May call web/docs/code/local tools
- Scores domains at domain level only

## Structural Flow

### Entry
1. Parse the query and flags.
2. Classify the search intent.
3. Select one best route unless ambiguity or flags justify more.

### Scenes
1. **PREPARE**: Parse query and classify route.
2. **ACT**: Dispatch to docs, web, code, or local search.
3. **ACQUIRE**: Collect search results and source metadata.
4. **VERIFY**: Apply trust scoring and route-specific quality checks.
5. **FINALIZE**: Present ranked results or fallback status.

### Transitions
- If `--docs`, `--code`, `--web`, `--strict`, `--wide`, or `--gitlab` is provided, flags override classifier.
- If docs route fails, fall back to web.
- If web search needs fetch escalation, use `oma search fetch` strategies.
- If query is purely local, use Serena MCP instead of web.

### Failure and recovery
- If primary route fails, fall forward to the next appropriate route.
- If trust score is weak, label it instead of hiding uncertainty.
- If no reliable results exist, report that and suggest a narrower query.

### Exit
- Success: results are routed, trust-scored, and source-grounded.
- Partial success: route failures or trust limitations are explicit.

## Logical Operations

### Actions
| Action | SSL primitive | Evidence |
|--------|---------------|----------|
| Parse query and flags | `READ` | User request |
| Classify intent | `SELECT` | Intent rules |
| Dispatch search route | `CALL_TOOL` | Docs, web, code, local tools |
| Collect results | `READ` | Search outputs |
| Score trust | `VALIDATE` | Trust registry |
| Rank and format | `INFER` | Relevance and trust |
| Report results | `NOTIFY` | Final answer |

### Tools and instruments
- Context7 docs tools
- Runtime-native web search
- `gh search code` or `glab api`
- Serena MCP for local project search

### Canonical command path
```bash
gh search code "<query>"
glab api "/search?scope=blobs&search=<query>"
```

For docs and web routes, use the runtime's available official-docs or web-search tools after classifying intent; do not duplicate routes unless the intent is ambiguous.

### Resource scope
| Scope | Resource target |
|-------|-----------------|
| `NETWORK` | Web/docs/source-code search targets |
| `CODEBASE` | Local files when local search is selected |
| `PROCESS` | `gh`, `glab`, and CLI search commands |
| `MEMORY` | Query classification, trust labels, selected results |

### Preconditions
- Query and route constraints are clear enough to classify.
- Required search tools are available or fallback is possible.

### Effects and side effects
- Performs external searches or local code searches.
- Produces ranked references that may influence downstream implementation or research.

### Guardrails
1. **Classify intent before searching**: every query goes through IntentClassifier first
2. **One query, one best route**: avoid redundant multi-route unless intent is ambiguous
3. **Trust score every result**: all non-local results get domain trust labels from the registry
4. **Flags override classifier**: user-provided flags (`--docs`, `--code`, `--web`, `--strict`, `--wide`, `--gitlab`) always take precedence
5. **Fail forward**: if primary route fails, fall back gracefully (docs->web, web->`oma search fetch` strategies)
6. **No additional MCP required**: Context7 for docs, runtime native for web, CLI for code, Serena for local
7. **Vendor-agnostic web search**: use whatever the current runtime provides (WebSearch, Google, Bing)
8. **Domain-level trust only**: do not attempt sub-path or page-level scoring

### Routes

| Route | Primary Tool | Fallback | Trigger |
|-------|-------------|----------|---------|
| `docs` | Context7 MCP (`resolve-library-id` → `query-docs`) | `web` route | Official docs, API reference |
| `web` | Runtime native search | `oma search fetch` (api/probe/impersonate/browser) | Tutorials, examples, solutions |
| `code` | `gh search code` / `glab api` | — | Implementation patterns, repos |
| `local` | Serena MCP (delegate) | — | Current project files, symbols |

### Default Workflow
1. **Parse** — Extract query, detect flags, classify intent
2. **Route** — Dispatch to the appropriate search channel(s)
3. **Collect** — Gather results from dispatched routes
4. **Score** — Attach trust labels to each result domain
5. **Present** — Format and rank results for the user

### Invocation

#### Standalone
```
/oma-search "React Server Components streaming"
/oma-search --docs "Next.js middleware"
/oma-search --code "PKCE implementation"
/oma-search --strict "JWT refresh token rotation"
```

#### Shared Infrastructure (from other skills)
Other skills reference oma-search by specifying intent and query:
1. State intent: `docs` | `web` | `code` | `local`
2. Pass query string
3. Use Trust Score in results to weigh source reliability

## References
Follow `resources/execution-protocol.md` step by step.
See `resources/examples.md` for input/output examples.
Use `resources/intent-rules.md` for intent classification reference.
Use `resources/trust-registry.md` for domain trust scoring reference.
Before submitting, run `resources/checklist.md`.
Vendor-specific execution protocols are injected automatically by `oma agent:spawn`.
Source files live under `../_shared/runtime/execution-protocols/{vendor}.md`.
- Execution steps: `resources/execution-protocol.md`
- Intent classification: `resources/intent-rules.md`
- Trust registry: `resources/trust-registry.md`
- Examples: `resources/examples.md`
- Checklist: `resources/checklist.md`
- Error recovery: `resources/error-playbook.md`
- Context loading: `../_shared/core/context-loading.md`
- Context budget: `../_shared/core/context-budget.md`
- Lessons learned: `../_shared/core/lessons-learned.md`

© First Fluke · MIT · first-fluke/oh-my-agent

Similar skills

All skills for Agent setup: memory, context, orchestration →

oma-search by other authors comes first.

oma-search First Fluke oma-search — a skill for Claude Code and Codex that routes queries across external documentation, web search, and remote code. It picks the matching retrieval channel and returns answers backed by citations. CX Codex +1 ★ 1,472repo stars OneTool MCP beycom OneTool MCP is an MCP server for Claude Code: agents call search, databases, files and diagrams as Python functions to save context window space. CX Codex +1 ★ 24repo stars microsoft-docs official github microsoft-docs finds official Microsoft documentation, tutorials, and code samples for Azure, .NET, VS Code, and GitHub work. Use it when an agent needs a source tied to a specific technology or version. CX Codex +1 14,881installs context7 intellectronica context7 is a Claude Code skill that fetches up-to-date library documentation via the Context7 API using curl. It runs when verifying API changes or fetching recent code examples. CX Codex +1 11,400installs context7-cli upstash The context7-cli skill teaches your agent to pull current library documentation through the ctx7 CLI and wire up Context7 MCP for the editor. CX Codex +1 8,900installs context7-mcp upstash context7-mcp is a Claude Code skill that retrieves current library and framework docs. It activates for setup questions, API lookups, and requests for code examples. CX Codex +1 7,200installs setup-context7-mcp NeoLabHQ The setup-context7-mcp skill walks the agent through setting up the Context7 MCP server and writes the library IDs into CLAUDE.md so code follows current docs. CX Codex +1 1,200installs

From the same set69

The whole set →
oma-brainstorm oma-brainstorm — a skill for exploring intent, constraints, and alternative approaches before planning or coding. Use it when you have an idea but the path forward is unclear. CX Codex +1 ★ 1,472repo stars oma-pm oma-pm — a skill for Claude Code and Codex decomposes product requirements into scoped tasks with dependencies and acceptance criteria. Generates plan artifacts for specialist agents and orchestrators. CX Codex +1 ★ 1,472repo stars oma-design oma-design resolves a project's design direction and maintains DESIGN.md as the visual contract. Picks an external design skill — Interface Design, Taste, or Impeccable — for the task at hand. CX Codex +1 ★ 1,472repo stars oma-hwp oma-hwp converts Korean HWP, HWPX, and HWPML documents into Markdown or JSON for LLM prompts and retrieval pipelines. CX Codex +1 ★ 1,472repo stars oma-image oma-image routes image generation requests across Codex, Pollinations and Gemini, and turns a reference picture into a new variation matching its style or layout. CX Codex +1 ★ 1,472repo stars oma-architecture oma-architecture is a Claude Code skill that helps design module and service boundaries, compare alternatives, and document architecture decisions as ADRs. CX Codex +1 ★ 1,472repo stars oma-coordination The oma-coordination skill guides manual coordination across specialist agents on multi-domain projects. It covers task planning, progress checks, contract alignment, and a final QA review. CX Codex +1 ★ 1,472repo stars oma-hwp oma-hwp turns Korean HWP, HWPX and HWPML documents into Markdown via kordoc. Extracts text, tables, lists, images and footnotes. CX Codex +1 ★ 1,472repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open