CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

smart-search

通过xiaobei受管浏览器搜索和阅读网页:选择站点、构造搜索 URL、使用默认或平台专用的持久化 session 并提取真实结果。如果已有 douyin-hunter、xhs-hunter、tiktok-hunter、kuaishou-hunter、x-hunter、weibo-hunter 或 wx-mp-hunter 技能,对应平台的内容搜索应该优先调用上面这些技能。

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/smart-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 dense, well-structured operational skill: clear routing tables, exact session/profile conventions, and a numbered search workflow with explicit validation, bounded budgets, and error-recovery rules that exceed typical checkpoint coverage. The main gap is that every detailed reference (17+ sites/*.md files and site-catalog.json) points outside the file, and none of those files are present in the reviewed bundle.

Suggestions

Ship the sites/*.md rule files and site-catalog.json alongside SKILL.md in the bundle — the body's core value (per-site URL construction and search rules) lives entirely in files that are absent here, leaving the URL-construction step unactionable as written.

Add one complete end-to-end example for the most common case (e.g., a concrete Bing search URL with an encoded Chinese keyword, the open command, and the expected snapshot/ref extraction) so the primary flow is copy-paste ready without opening a site file.

Consolidate the hunter-skill routing rule into its dedicated table and drop the repeated caveats from the session and site-selection tables (cross-reference the section instead) to reclaim tokens without losing clarity.

DimensionReasoningScore

Conciseness

The body is dense operational rules and tables with no concept-explanation padding — nothing teaches Claude what a browser or search engine is. Not 5 because the hunter-routing rule is restated about four times (dedicated section, session table caveats, site-table rows, closing guidance) and the --persistent rule is repeated, so it could be tightened; not 3 since the restatement is contextual reinforcement at decision points rather than unnecessary explanation.

4 / 5

Actionability

Concrete, executable guidance throughout: exact profile names (default/douyin/xhs-browse/twitter/weibo/tiktok), exact flags, a real command ("camoufox-cli --persistent --json open '<按 sites/zhihu.md 生成的完整搜索URL>'"), exact budgets ("每站最多两次搜索导航/翻页"), and specific field rules ("保留小红书 xsec_token 等访问参数"). Not 5: only one command example with a placeholder URL — no complete end-to-end example (e.g., a concrete Bing search URL plus snapshot/extract flow) covering the most common case.

4 / 5

Workflow Clarity

The 7-step 搜索执行 sequence includes explicit validation checkpoints and feedback loops: bounded waits with "不把空骨架判为无结果", "精确日期到原文核实", timeout recovery via "延迟或超时先核对同一页面和会话状态,不自动重启全部浏览器", and closing self-reporting of sites, counts, and gaps. Not 4 because checkpoints are explicit and comprehensive rather than 'mostly present'; the destructive/batch cap does not apply to a read-only search skill, and the pagination batch is explicitly bounded.

5 / 5

Progressive Disclosure

Good structure: the site-selection table clearly maps each search goal to one-level-deep sites/*.md rule files with descriptive purposes, and site-catalog.json centralizes the six new site categories. Not 5 because the referenced files (sites/*.md, site-catalog.json) are absent from the bundle being reviewed, so the reference structure cannot be verified as real, and browser-guide is referenced without a resolvable path.

4 / 5

Total

17

/

20

Passed

Description

66%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.

The description is concrete and specific about capabilities and platform routing, with good natural trigger keywords, but it never states when to invoke this skill itself — the only 'when' guidance delegates away to other skills. Adding an explicit trigger clause (e.g., 当用户需要实际打开网页搜索、登录站内搜索或读取渲染结果时使用) would raise completeness from 3 to 5.

Suggestions

Add an explicit 'Use when…' trigger clause stating when to invoke this skill itself, e.g. "当用户需要实际打开网页搜索、使用站内搜索/筛选条件或读取渲染后的页面内容时使用;仅在需要登录站内或页面交互时,而不是普通 API 检索。"

Include natural Chinese synonyms users would actually say — 查找、检索、浏览网页、打开网页 — and Chinese platform names (抖音、小红书、快手、微博、微信公众号) alongside the English hunter-skill identifiers, to improve trigger-term coverage.

Briefly name the supported search categories (通用搜索、问答、视频、学术、新闻、职位、商品) so the description's capability coverage matches what the body actually supports.

DimensionReasoningScore

Specificity

"选择站点、构造搜索 URL、使用默认或平台专用的持久化 session 并提取真实结果" names the domain and several concrete actions (site selection, URL construction, session handling, result extraction), matching the 'several specific actions with minor gaps' anchor. Not 5 because capabilities the body covers — reading full pages, pagination, result verification — are omitted, so coverage is not comprehensive.

4 / 5

Completeness

The 'what' is clear (managed-browser search: select sites, build URLs, use persistent sessions, extract real results), but there is no 'Use when…' clause or equivalent explicit trigger for invoking this skill — the second sentence only routes away to the hunter skills. Per the judging guideline, a missing explicit trigger caps completeness at 3; not 4 because 'when' is absent, not merely under-specified.

3 / 5

Trigger Term Quality

"搜索和阅读网页" plus seven platform identifiers (douyin, xhs, tiktok, kuaishou, x, weibo, wx-mp) give good natural keyword coverage. Not 5: common synonyms users would say are missing (查找/检索/浏览/打开网页, Chinese platform names 抖音/小红书/快手/微博), and "xiaobei受管浏览器" is internal jargon; not 3 because coverage clearly exceeds 'works with files'-level generality.

4 / 5

Distinctiveness Conflict Risk

The niche (managed-browser web search with camoufox persistent sessions) is distinct, and the description explicitly manages overlap by deferring to the seven hunter skills. Not 5 because "搜索和阅读网页" is a broad trigger that could still match other web-search or browsing skills not named in the routing rule.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 24 missing

Warning

Total

13

/

16

Passed

Repository

TeamWiseFlow/xiaobei

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.