---
name: skyworkai-skywork-search
description: "Search the web for real-time information using the Skywork web search API. Use this skill whenever the user needs up-to-date information from the internet — for example, researching a topic, looking up recent events, finding facts or statistics, gathering material for a document or presentation, or answering questions that require current data. Also trigger when the user says things like \"search for\" / \"搜索\" / \"検索\" / \"검색\", \"look up\" / \"查询\" / \"調べる\" / \"조회하다\", \"find information about\" / \"查找关于……的信息\""
license: "MIT"
metadata:
  decimalai-skill-id: "333199d1-581f-48b7-b836-63573c47e43b"
  decimalai-version-id: "7fa38b7e-27ff-49c2-92ff-c417ca5f9caf"
  decimalai-version: "1"
  decimalai-body-sha256: "f86a1557799fa3597ff4897b5f7d4e866db84c808bfbd79e42e319cd7dc132b9"
  decimalai-name: "skyworkai/Skywork Search"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "research"
  decimalai-source: "https://app.decimal.ai/s/skyworkai-skywork-search@1/SKILL.md"
---
# Web Search Skill

Search the web for real-time information via the Skywork search API. This skill lets you run up to 3 queries in a single invocation and returns structured results with source URLs and content snippets.

## When to use

- The user asks you to research a topic or find current information
- You need up-to-date facts, statistics, or news to answer a question
- Another task (writing a report, creating a PPT, drafting a document) needs web research as a preliminary step
- The user explicitly asks to search or look something up

## Prerequisites

### API Key Configuration (Required First)
This skill requires a **SKYWORK_API_KEY** to be configured in OpenClaw.

If you don't have an API key yet, please visit:
**https://skywork.ai**

For detailed setup instructions, see:
[references/apikey-fetch.md](references/apikey-fetch.md)

## How to use

Run the bundled script from this skill's `scripts/` directory:

```bash
python3 <skill-path>/scripts/web_search.py "query1" ["query2"] ["query3"]
```

- Pass 1–3 search queries as positional arguments
- Results are saved to individual text files in a temporary directory
- The script prints the file paths to stdout so you can read them

## Crafting good queries

Search quality depends heavily on query phrasing. A few tips:

- **Be specific**: "Tesla Q4 2025 revenue" works better than "Tesla financials"
- **Use natural language**: The API handles full questions well — "What is the current population of Tokyo?" is fine
- **Split broad topics**: If the user wants a comprehensive overview, break it into 2–3 focused queries rather than one vague one
- **Include time context** when relevant: "best Python web frameworks 2026" rather than just "best Python web frameworks"

## Reading results

After running the script, read the output files. Each file contains:

```
query: <the original query>

[result-1] <source URL>
<content snippet>

[result-2] <source URL>
<content snippet>
...
```

Synthesize the results into a clear answer for the user. Always cite sources when presenting factual information — include the URLs from the results so the user can verify.

## Example workflow

User asks: "What are the latest developments in quantum computing?"

1. Run the search with focused queries:
   ```bash
   python3 <skill-path>/scripts/web_search.py \
     "quantum computing breakthroughs 2026" \
     "quantum computing industry news latest"
   ```
2. Read the result files
3. Synthesize findings into a clear, sourced summary for the user

## Limitations

- Maximum 3 queries per invocation (the script caps it)
- Each query has a 30-second timeout
- Results depend on the Skywork search API availability