CtrlK
BlogDocsLog inGet started
Tessl Logo

search-web

使用内置 search_web.py 脚本进行联网搜索问答,准备清晰具体的问题。

58

Quality

66%

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 ./.trae/openclaw-skills/search-web/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is well-structured, concise, and actionable with a real executable example and verified bundle reference. Its main weakness is a vague directory hint in the run step, which slightly limits workflow clarity and actionability.

Suggestions

Replace '运行之前cd到对应的目录' with an explicit path, e.g. 'run from the skill root so scripts/search_web.py resolves'.

Add a brief note on required environment variables (MODEL_SEARCH_API_KEY / ARK_API_KEY, SEARCH_BOT_ID) so the command actually runs without trial and error.

Clarify how to enable the advanced features (e.g. which console or which argument sets model=thinking) so the section is actionable rather than descriptive.

DimensionReasoningScore

Conciseness

The body is lean and sectioned without padding concepts Claude already knows; only minor items like 'Token 使用情况' and the advanced-feature bullets could be trimmed.

4 / 5

Actionability

Provides an executable command and a concrete example ('python scripts/search_web.py "荣耀手机的最新动态"'), but the 'cd到对应的目录' hint is vague about which directory.

4 / 5

Workflow Clarity

A clear numbered sequence (prepare question → run script → receive answer) for a simple, non-destructive task; the only gap is the unspecified target directory in step 2.

4 / 5

Progressive Disclosure

Under 50 lines, well-organized into clear sections, with a single referenced bundle path (scripts/search_web.py) that exists and no nested references — appropriate for a small single-purpose skill.

5 / 5

Total

17

/

20

Passed

Description

53%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 conveys a clear single purpose (web search Q&A via a named script) but omits explicit trigger guidance and offers only minimal keyword variation. It is specific enough to be distinguishable yet incomplete as a 'when to use' signal.

Suggestions

Add a 'Use when...' clause stating when to invoke this skill, e.g. 'Use when the user asks to search the web or look up current information online.'

Broaden trigger terms with natural synonyms users actually say, such as '搜索网络', '查资料', '联网查询', alongside '联网搜索问答'.

Mention the key output affordances (参考来源, 追问建议) in the description to make the capability more concrete.

DimensionReasoningScore

Specificity

Names a concrete tool ('内置 search_web.py 脚本') and 1-2 actions ('联网搜索问答', '准备清晰具体的问题'), but coverage is not comprehensive — only one core capability is described.

3 / 5

Completeness

Clearly states what the skill does, but there is no 'Use when...' clause or equivalent trigger guidance, capping completeness at 3 per the rubric.

3 / 5

Trigger Term Quality

Contains relevant keywords ('联网搜索', '问答') a user might say, but lacks common variations/synonyms (e.g. '搜索网络', '查资料') and a natural trigger phrase.

3 / 5

Distinctiveness Conflict Risk

The named script and '联网搜索问答' niche are mostly distinct from other skills, with only minor overlap risk against general research/web tools.

4 / 5

Total

13

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
huangruiteng/CS-Notes
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.