omnisearch

# OmniSearch Skill - Web Search Tool

## CRITICAL: When to Use This Skill

**ALWAYS use OmniSearch when:**
- User explicitly asks to "search", "google", "look up", "find online"
- User asks about current events, news, or recent developments
- User requests prices, product specs, reviews, or comparisons
- User asks "what's the latest..." or "what's happening with..."
- You need to verify current facts, statistics, or data
- User asks about people, companies, or organizations you don't know
- Information might have changed since your training cutoff
- User needs sources or citations for factual claims

**Examples of queries requiring OmniSearch:**
- "What's the weather in Hamburg today?"
- "Search for iPhone 16 reviews"
- "What happened in the tech industry this week?"
- "Find the current price of Bitcoin"
- "Look up restaurants near me"
- "What are people saying about the new Tesla model?"

## DO NOT Use OmniSearch When:
- Answering from your existing knowledge is sufficient and current
- User is asking for creative content, code, or analysis
- Question is about concepts, definitions, or timeless information

---

## How to Execute Search

**IMPORTANT**: Run the script from the omnisearch skill directory using the relative path `./scripts/omnisearch.sh`

### Method 1: Recommended (Wrapper Script)

Use the wrapper script for all searches:

```bash
# AI-enhanced search (includes summarization) - USE THIS FOR MOST QUERIES
./scripts/omnisearch.sh ai "your search query here"

# Raw web search results (when you need direct source material)
./scripts/omnisearch.sh web "your search query here"
```

**Available providers:**
- **ai** type: `perplexity` (default - recommended for most queries)
- **web** type: `perplexity` (default), `brave`, `kagi`, `tavily`, `exa`

**Optional provider override:**
```bash
./scripts/omnisearch.sh ai "query" perplexity
./scripts/omnisearch.sh web "query" brave
./scripts/omnisearch.sh web "query" kagi
./scripts/omnisearch.sh web "query" tavily
./s...