Agent skill

OpenCLI Smart Search Router

by jackwener in jackwener/OpenCLI

Routes a search question to the most suitable opencli source, normally one AI site plus up to two specialist sites, with call limits per question and a recap at the end.

Apache-2.0Auto-check passedProductivity & Automation

SKILL.md written in Chinese; this summary is our English description.

Install OpenCLI Smart Search Router

skills CLI
$ npx skills add jackwener/OpenCLI --skill smart-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jackwener/OpenCLI smart-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jackwener/OpenCLI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/smart-search .claude/skills/smart-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
smart-search
GitHub stars
30k
Used in
2 other repos
Token cost
~753 tokens
SKILL.md length
238 words
Files
9 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Routes a search question to the most suitable opencli source, normally one AI site plus up to two specialist sites, with call limits per question and a recap at the end.

  • Works in 3 steps: 当用户明确指定网站、平台或数据源时,直接使用对应网站。 → 当用户没有指定网站时,优先只选择一个 AI… → 当 AI 返回内容不足、缺少原始数据、需要权威佐证或需要垂直结果时,再补充…
  • Searching a named website or social platform through opencli
  • SKILL.md covers 强制预检, 主路由规则, 单题预算与频率限制 and 查询结束汇报, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Written in Chinese, this skill makes the agent decide which opencli data source to query before it searches. It must first run `opencli list -f yaml` to see which sites exist and then ask the chosen site for its own help with `-h`, and it avoids hard-coding command signatures so that the live help stays the source of truth.

Routing is simple. If you name a site, the skill uses it. Otherwise it chooses a single AI source from grok, doubao and gemini based on language and context, and adds one or two specialist sources only when the AI answer lacks raw posts, authority or vertical detail. It also advises writing AI queries as topic, goal and constraints rather than a bare keyword.

Each AI site is called at most once per question and other sites at most twice, tracked in a ledger of site, query, count and status. Failed or rate-limited sources are skipped in favor of similar ones, and every answer ends with a short summary of the sites used, the terms searched and the call counts. Source lists for AI, information, media, shopping, social, tech, travel and other categories sit in the references folder.

When your agent uses it

  • Searching a named website or social platform through opencli
  • Researching a topic when no source site has been chosen yet
  • Looking up shopping, travel, job or finance information with live CLI sources
  • Searching Chinese-language content across several sites

Example prompts

  • “Use opencli to find recent discussion about electric scooters in Berlin.”
  • “Search for Chinese reviews of robot vacuums and tell me which sites you used.”
  • “Find software engineer job listings in Shenzhen using opencli.”
  • “Compare what Gemini and the shopping sources say about noise-cancelling headphones.”

Requirements

  • The `opencli` command-line tool

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 当用户明确指定网站、平台或数据源时,直接使用对应网站。
  2. 当用户没有指定网站时,优先只选择一个 AI 源:grok、doubao、gemini 三选一。
  3. 当 AI 返回内容不足、缺少原始数据、需要权威佐证或需要垂直结果时,再补充 1-2 个专用源。

What it can do on your machine

Read from SKILL.md and the folder at commit 2413694. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OpenCLI Smart Search Router loads about 753 tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 238 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~753
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jackwener/OpenCLI at commit 2413694, republished under its Apache-2.0 licence (© jackwener). 238 words, ~753 tokens.

Download SKILL.mdSave it as .claude/skills/smart-search/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
smart-search
description
基于 opencli 命令的智能搜索路由器。当用户想要使用 OpenCLI、CLI 或 API 搜索、查询、查找或研究信息时,尤其是涉及指定网站、社交媒体、技术资料、新闻、购物、旅游、求职、金融或中文内容时,务必使用此 skill

智能搜索路由器

根据话题和场景,将查询路由到最佳的 opencli 搜索源。此 skill 的核心目标不是记忆命令,而是先定位数据源,再让 Agent 通过 opencli 自己读取实时帮助,避免文档漂移。

强制预检

每次使用前,必须先做下面两步:

  • 运行 opencli list -f yaml
  • 用 live registry 确认候选站点是否存在,并检查 strategy、browser、domain

选定站点后,必须再做下面两步:

  • 运行 opencli <site> -h 查看该站点有哪些子命令
  • 若已锁定某个子命令,再运行 opencli <site> <command> -h 查看参数、输出列、策略

不要在 skill 文档里硬编码参数或假设命令签名;以 opencli ... -h 的实时输出为准。

主路由规则

只使用这一条规则,不再维护多套优先级:

  1. 当用户明确指定网站、平台或数据源时,直接使用对应网站。
  2. 当用户没有指定网站时,优先只选择一个 AI 源:grok、doubao、gemini 三选一。
  3. 当 AI 返回内容不足、缺少原始数据、需要权威佐证或需要垂直结果时,再补充 1-2 个专用源。

单题预算与频率限制

把“单个用户问题”理解为同一意图链路下的一次问题求解;同一轮追问、澄清、补充条件,若核心问题未变,仍算同一题。

先建立一份站点调用台账。每次真正执行搜索命令后,立刻更新:

  • site
  • query
  • count
  • status

计数规则:

  • opencli list -f yaml、opencli <site> -h、opencli <site> <command> -h 属于预检与帮助,不计入搜索次数
  • 一次真正的 opencli <site> ... 搜索/查询执行,计为该站点 1 次调用
  • 同站点因为报错、超时、验证码、反爬、登录态异常而失败,也算 1 次调用,不要无限重试

频率上限:

  • AI 站点硬限制:同一题内,每个 AI 站点最多调用 1 次
  • 默认策略仍然是只选 1 个 AI 站点,不要把多个 AI 站点串成常规流程
  • 只有当用户明确要求比较多个 AI 站点时,才可以额外调用其他 AI 站点;但每个被点名的 AI 站点仍然最多 1 次
  • 非 AI 站点默认最多调用 2 次
  • 非 AI 站点第 2 次调用必须有明确理由,例如第一次结果过宽,需要加时间、地区、类别、排序或关键词限定
  • 非 AI 站点不要进行第 3 次调用;若信息仍不足,停止扩搜并明确说明缺口

触发限频后的处理:

  • 记录:「已跳过:<site> 达到频率上限」
  • 优先改用其他同类站点
  • 若没有合适替代源,则直接基于已收集信息回答,并说明覆盖范围与缺口

查询结束汇报

每次查询结束后,回答末尾必须追加一段简短的“搜索摘要”,至少包含下面三项:

  • 使用了什么网站搜索
  • 每个网站搜了什么词
  • 每个网站搜了几次

如果有被限频跳过的站点,也要明确写出。

建议使用下面的固定格式:

md
搜索摘要
- 网站:<site1> | 查询词:<term1> | 次数:<n>
- 网站:<site2> | 查询词:<term2>;<term3> | 次数:<n>
- 已跳过:<site3>,原因:达到频率上限

AI 源选择

  • grok 适合实时讨论、英文互联网舆论、Twitter/X 语境、热点追踪。
  • doubao 适合中文语境、字节抖音生态、生活方式内容、中文热点与泛中文问答。
  • gemini 适合全球网页、英文资料、通用信息检索、背景综述。

如果用户没有指定网站,默认先判断语言和语境,再从这三个里只选一个。

一旦某个 AI 站点已经执行过一次真实查询,就不要在同一题里改写关键词后再次调用该 AI 站点。若答案不足,优先补专用源,不要反复追打同一个 AI 站点。

AI 查询词建议

当使用 AI 源时,不要只丢一个过短关键词。优先构造成“主题 + 目标 + 限定条件”的查询。

  • 主题 用户真正要查的对象、事件、产品、人物、公司、技术名词。
  • 目标 想要什么结果,例如总结、对比、原因、趋势、推荐、原始线索。
  • 限定条件 语言、地区、时间范围、平台范围、受众、价格带、岗位地点、是否要引用原始来源。

优先使用下面这种表达方式:

  • <主题> + <你要回答的问题>
  • <主题> + <时间范围/地区/语言>
  • <主题> + <平台或来源范围>
  • <主题> + <输出要求>

避免只输入:

  • 单个名词
  • 没有时间范围的热点问题
  • 没有地区限制的购物、求职、旅游问题
  • 没有平台限制的社交媒体问题

专用源补充时机

当出现以下任一情况时,再补充专用源:

  • AI 给出的是摘要,但你需要原始帖子、原始视频、原始商品或原始职位结果
  • AI 覆盖面不足,漏掉垂直站点信息
  • 需要更高权威性或更强领域相关性
  • 用户明确要求“从某个平台找”

单次查询通常控制在 1 个 AI 源 + 1 到 2 个专用源,避免结果过载。

处理不可用的源

当站点不可用时:

  • 不要因为单个源失败而中止整个搜索
  • 记录:「已跳过:<site> 不可用」
  • 回退到同类其他站点,或回退到一个 AI 源
  • 始终以 opencli list -f yaml 与 opencli <site> -h 的实际结果为准

不要假设任何站点“绝对可用”。即使是公开站点,也以当前环境中的 live help 和执行结果为准。

参考文件

根据需要读取对应文件:

  • references/sources-ai.md — AI 默认源
  • references/sources-tech.md — 技术 / 学术
  • references/sources-social.md — 社交媒体
  • references/sources-media.md — 媒体 / 娱乐
  • references/sources-info.md — 资讯 / 知识
  • references/sources-shopping.md — 购物
  • references/sources-travel.md — 旅游
  • references/sources-other.md — 其他垂直源

只读与当前查询相关的文件,无需全部加载。

© jackwener, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in skills/smart-search of jackwener/OpenCLI.

  • SKILL.md
  • references/sources-ai.md
  • references/sources-info.md
  • references/sources-media.md
  • references/sources-other.md
  • references/sources-shopping.md
  • references/sources-social.md
  • references/sources-tech.md
  • references/sources-travel.md

Open the folder on GitHubat commit 2413694

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in jackwener/OpenCLI, which our catalogue first saw on October 7, 2026.

Compare with similar skills

OpenCLI Smart Search Router next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OpenCLI Smart Search Router compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OpenCLI Smart Search Router this skilljackwener/OpenCLI30k2 repos~753Automated safety check: PassApache-2.0
Scenario Gemini Imagescenario-labs/skills931—~1.5kAutomated safety check: PassMIT
Web Access via Browser CDPeze-is/web-access9.1k4 repos~2.2kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach94k—~1.4kAutomated safety check: PassMIT
Tavily Web Searchallenpeng0705/EnvoyMesh3.1k3 repos~2.5kAutomated safety check: NotesNone
Brave Searchbadlogic/pi-skills2.6k5 repos~592Automated safety check: PassMIT

Similar skills

  • Scenario Gemini Image

    scenario-labs/skills

    A skill your agent uses when generating or editing images with Google's Gemini image models (Nano Banana) on Scenario via MCP: text-to-image, natural-language instruction editing, identity locking…

    931 GitHub stars~1.5k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Routes every web task, from searching to logged-in browsing, through a tiered choice of search, fetch, curl or a real Chrome or Edge session driven over CDP.

    9.1k GitHub starsUsed in 4 repos~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    94k GitHub stars~1.4k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Tavily Web Search

    allenpeng0705/EnvoyMesh

    Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

    3.1k GitHub starsUsed in 3 repos~2.5k tokens
    Productivity & AutomationAuto-check: notes
  • Brave Search

    badlogic/pi-skills

    Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

    2.6k GitHub starsUsed in 5 repos~592 tokens
    Productivity & AutomationAuto-check passed
  • Modsearch

    liustack/modsearch

    Plug-in web search, X (Twitter) search, and page fetch for models without native web access.

    612 GitHub stars~2.6k tokensUpdated 5 days ago
    Productivity & AutomationAuto-check: notes

More from jackwener/OpenCLI

  • OpenCLI Adapter Author

    jackwener/OpenCLI

    Walks through writing an OpenCLI adapter for a new site or a new command on an existing one, from first recon and field decoding to coding and verification.

    30k GitHub starsUsed in 1 repo~3.4k tokens
    Auto-check passed
  • OpenCLI Browser Control

    jackwener/OpenCLI

    Drives a real Chrome window through the opencli CLI to inspect pages, fill forms, click through logged-in flows and extract data from structured command responses.

    30k GitHub starsUsed in 2 repos~7.3k tokens
    Auto-check passed
  • OpenCLI Adapter Autofix

    jackwener/OpenCLI

    Repairs a broken OpenCLI site adapter after a command fails: collects a trace, patches only the adapter, retries, and files an upstream GitHub issue once fixed.

    30k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • OpenCLI Usage Map

    jackwener/OpenCLI

    Orients an agent on OpenCLI, which turns websites and Electron apps into opencli site-command calls, covering adapters, strategies, install and which skill to load next.

    30k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed

Works with

Questions about OpenCLI Smart Search Router

What does OpenCLI Smart Search Router do?

Routes a search question to the most suitable opencli source, normally one AI site plus up to two specialist sites, with call limits per question and a recap at the end. Written in Chinese, this skill makes the agent decide which opencli data source to query before it searches. It must first run `opencli list -f yaml` to see which sites exist and then ask the chosen site for its own help with `-h`, and it avoids hard-coding command signatures so that the live help stays the source of truth.

When should I use OpenCLI Smart Search Router?

OpenCLI Smart Search Router fits situations like: searching a named website or social platform through opencli; researching a topic when no source site has been chosen yet; looking up shopping, travel, job or finance information with live CLI sources; searching Chinese-language content across several sites.

How do I install OpenCLI Smart Search Router in Claude Code?

Run `npx skills add jackwener/OpenCLI --skill smart-search -a claude-code`. Or copy the skill folder (skills/smart-search in jackwener/OpenCLI) into .claude/skills/smart-search in your project. Claude Code loads it when a task matches its description.

How do I install OpenCLI Smart Search Router in Codex?

Run `npx skills add jackwener/OpenCLI --skill smart-search -a codex`. Or copy the skill folder (skills/smart-search in jackwener/OpenCLI) into .agents/skills/smart-search in your project. Codex loads it when a task matches its description.

Can I use OpenCLI Smart Search Router in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jackwener/OpenCLI --skill smart-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/smart-search, .gemini/skills/smart-search, .github/skills/smart-search and .opencode/skills/smart-search in your project.

What does OpenCLI Smart Search Router need to run?

SKILL.md names no scripts, command-line tools or credentials: OpenCLI Smart Search Router is instructions for the agent only. Our summary lists: The `opencli` command-line tool.

Does OpenCLI Smart Search Router access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is OpenCLI Smart Search Router safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OpenCLI Smart Search Router use?

OpenCLI Smart Search Router is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OpenCLI Smart Search Router use?

About 753 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.5k tokens, read only when the agent opens those files.

What are the alternatives to OpenCLI Smart Search Router?

Skills that share tags, products or a category with OpenCLI Smart Search Router: Scenario Gemini Image (scenario-labs/skills, 931 stars), Web Access via Browser CDP (eze-is/web-access, 9.1k stars), Agent Reach (Panniantong/Agent-Reach, 94k stars) and Tavily Web Search (allenpeng0705/EnvoyMesh, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OpenCLI Smart Search Router?

jackwener (a GitHub user) maintains it in jackwener/OpenCLI, which has 29,955 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 24, 2026.

Source: jackwener/OpenCLI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.