smart-search SKILL.md skillA

smart-search from mxyhi/ok-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mxyhi/ok-skills/smart-search@git:20260505.68ac96f

Pins git:20260505.68ac96f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mxyhi/ok-skills
Path
opencli/smart-search/SKILL.md
Versions recorded
2
Latest version
git:20260505.68ac96f, committed May 5, 2026
First version recorded
Apr 11, 2026
Size
6,351 bytes
Repository stars
509
License
Apache-2.0

基于 opencli 命令的智能搜索路由器。当用户想要使用 OpenCLI、CLI 或 API 搜索、查询、查找或研究信息时,尤其是涉及指定网站、社交媒体、技术资料、新闻、购物、旅游、求职、金融或中文内容时,务必使用此 skill.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 智能搜索路由器

根据话题和场景,将查询路由到最佳的 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> 达到频率上限」
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mxyhi/ok-skills/smart-search@sha256:0aa29dfe8c17816f

The line at the top of this page pins the label git:20260505.68ac96f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3swvu4stkp62u2zu.svg)](https://markdownregistry.com/a/art_3swvu4stkp62u2zu)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Apr 11, 2026 and May 5, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
git:20260505.68ac96f latest2026-05-05 68ac96f 6,351 BA view · diff
git:20260411.609aeb92026-04-11 609aeb9 6,322 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6351 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mxyhi/ok-skills · 509 stars · license Apache-2.0 · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3swvu4stkp62u2zu
GET https://markdownregistry.com/api/v1/resolve?ref=mxyhi/ok-skills/smart-search
GET https://markdownregistry.com/api/v1/blob/0aa29dfe8c17816f00022047eab3121e646f60f31a671b0765fd01f8c26c0f01

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mxyhi/ok-skills

AGENTS.md AGENTS.md file
mxyhi/ok-skills · AGENTS.md
git:20260925.7de4640 · audit A · 509 stars
agent-browser SKILL.md skill
mxyhi/ok-skills · agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
git:20260831.972d952 · audit A · 509 stars
ai-elements SKILL.md skill
mxyhi/ok-skills · ai-elements/SKILL.md · Build AI chat interfaces using ai-elements components — conversations, messages, tool displays, prompt inputs, and…
git:20260314.07e5678 · audit A · 509 stars
autoresearch SKILL.md skill
mxyhi/ok-skills · autoresearch/SKILL.md · Autonomous iteration loop: modify, verify, keep/discard against any metric
v2.2.2 · audit A · 509 stars
ax SKILL.md skill
mxyhi/ok-skills · ax/SKILL.md · Use the ax CLI instead of curl + throwaway parsing scripts whenever you fetch a URL, explore an unknown web page, or…
git:20260731.b493166 · audit A · 509 stars
better-icons SKILL.md skill
mxyhi/ok-skills · better-icons/SKILL.md · Use when working with icons in any project. Provides CLI for searching 200+ icon libraries (Iconify) and retrieving…
git:20260415.87a17fa · audit A · 509 stars
bopomofo-rescue SKILL.md skill
mxyhi/ok-skills · bopomofo-rescue/SKILL.md · Detect and recover text that was accidentally typed with the Taiwanese Bopomofo / Zhuyin (注音) keyboard while the input…
git:20261018.2c986bf · audit A · 509 stars
browser-trace SKILL.md skill
mxyhi/ok-skills · browser-trace/SKILL.md · Capture a full DevTools-protocol trace of any browser automation — CDP firehose, screenshots, and DOM dumps — then…
git:20260517.ccd356a · audit A · 509 stars
codebase-design SKILL.md skill
mxyhi/ok-skills · codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
git:20260831.e7f2564 · audit A · 509 stars
deep-research SKILL.md skill
mxyhi/ok-skills · deep-research/SKILL.md · Professional deep research report generation — multi-agent collaboration with parallel chapter writing, automatic…
v6.0.0 · audit A · 509 stars
diagnosing-bugs SKILL.md skill
mxyhi/ok-skills · diagnosing-bugs/SKILL.md · Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports…
git:20261009.b4e20e9 · audit A · 509 stars
domain-modeling SKILL.md skill
mxyhi/ok-skills · domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md…
git:20260930.4ade426 · audit A · 509 stars

Every file in mxyhi/ok-skills

Other files named smart-search

smart-search SKILL.md skill
aisa-team/agent-skills · search-research/smart-search/SKILL.md · Intelligent hybrid search combining web and academic sources via AIsa Smart Search endpoint. Best when you need both…
v1.0.1 · audit A · 28 stars
smart-search SKILL.md skill
chainlesschain/chainlesschain · desktop-app-vue/src/main/ai-engine/cowork/skills/builtin/smart-search/SKILL.md · Use this for hybrid Vector+BM25 search to find specific existing info in the knowledge base—use only for factual…
v1.0.0 · audit A · 11 stars

Browse by kind, by grade A, or by owner.