CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

smart-search

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

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered instruction skill: concrete commands, explicit budgets, error-recovery paths, and a clean one-level reference structure, with the anti-hardcoding stance explicitly justified. Its only real cost is modest redundancy in the repeated AI-source rules.

DimensionReasoningScore

Conciseness

The body is directive and lean with essentially no explanation of concepts Claude already knows; every section adds tool-specific rules the model could not infer. Minor redundancy — the 'one AI source only' rule is restated across 主路由规则, 频率限制, and AI 源选择 — keeps it below the 'every token earns its place' anchor.

4 / 5

Actionability

Concrete commands (`opencli list -f yaml`, `opencli <site> -h`, `opencli <site> <command> -h`), hard numeric limits (max 1 AI call, max 2 non-AI calls), a fixed ledger schema, and a copy-paste report template make the guidance mostly executable. Placeholders instead of full search invocations are explicitly justified ('以 `opencli ... -h` 的实时输出为准'), so no penalty applies, but no concrete end-to-end example exists either, holding it at 4 rather than 5.

4 / 5

Workflow Clarity

The workflow is clearly sequenced: a mandatory two-stage precheck (registry → site help → subcommand help), a single routing rule, an incrementally updated call ledger, and a mandatory post-query report. Validation checkpoints are explicit (verify sites against live registry before use) and error-recovery loops are spelled out for both rate limits (record skip → switch source → answer with stated gaps) and unavailable sources (do not abort → record → fall back).

5 / 5

Progressive Disclosure

The SKILL.md body is an overview only, and the 参考文件 section clearly signals eight one-level-deep, domain-organized references (`references/sources-ai.md` … `sources-other.md`), all of which exist and contain no further nesting. The instruction to load only files relevant to the current query rounds out easy navigation.

5 / 5

Total

18

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states a clear capability, uses third person, includes an explicit and mandatory 'use when' clause, and enumerates many natural domain triggers. The main weakness is that 'what it does' rests on a single routing action rather than enumerating the skill's concrete capabilities.

Suggestions

Enumerate 2-3 concrete capabilities after the routing statement, e.g., '将查询路由到最佳 opencli 搜索源,执行预检、控制各站点调用预算并生成搜索摘要' — this would lift specificity from 3 to 4.

Add a few more natural trigger synonyms users might say (e.g., '查资料', '检索', '看看某站点上有什么') to close the remaining keyword gaps.

DimensionReasoningScore

Specificity

The description names the tool ('基于 opencli 命令') and one concrete action ('智能搜索路由器' — routing queries to the best search source), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It does not list several specific capabilities (e.g., per-site budget enforcement, preflight help checks, search summaries), so it is not a 4.

3 / 5

Completeness

It explicitly answers 'what' ('基于 opencli 命令的智能搜索路由器') and 'when' with a concrete, mandatory trigger clause ('当用户想要…务必使用此 skill') listing concrete trigger phrases. Both what and when are explicitly and concretely present.

5 / 5

Trigger Term Quality

It covers four natural verb triggers (搜索、查询、查找、研究) plus nine domain triggers (指定网站、社交媒体、技术资料、新闻、购物、旅游、求职、金融、中文内容), which is good keyword coverage. A few natural variations (e.g., 'look up', 'browse', tool-specific aliases) are missing, so it is not a 5.

4 / 5

Distinctiveness Conflict Risk

The opencli-specific framing ('基于 opencli 命令的智能搜索路由器') carves a clear niche with domain-specific triggers, but the generic verbs '搜索、查询、查找或研究信息' carry minor overlap risk with any general web-search or research skill, keeping it below 5.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jackwener/OpenCLI

Path

skills/smart-search/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.