CtrlK
BlogDocsLog inGet started
Tessl Logo

web-search

This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.

62

Quality

73%

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 ./configs/microservice/bff-service/configs/agent-skills/clawhub/web-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 highly actionable — every command is executable, flags are verified against the actual script, and output formats are illustrated — with a clear workflow and error-recovery guidance. Its main weakness is verbosity and duplication: usage patterns, advanced use cases, and the resources section restate the same flag combinations, inflating the file to ~514 lines where a quick-reference plus a references file would do. Progressive disclosure is adequate but everything is inlined in SKILL.md rather than split across the bundle.

Suggestions

Cut the redundant sections: "Common Usage Patterns", "Advanced Use Cases", and "Resources" repeat flag combinations and script features already covered in sections 1-10 and the Quick Reference — replacing them with 2-3 representative combined examples would remove ~150 lines.

Move the per-filter option catalogs (image size/color/type/layout and video duration/resolution) and the usage-pattern cookbook into a references/options.md file, keeping SKILL.md as a concise overview with a Quick Reference table plus one-level-deep pointers.

Trim the "Useful for"/"Great for" bullet lists under each capability and the "When to Use This Skill" section (which duplicates the frontmatter description), trusting the description and trigger guidance to carry that load.

DimensionReasoningScore

Conciseness

At ~514 lines for a single CLI wrapper, the body has several padded sections: "When to Use This Skill" repeats the frontmatter description, each capability carries "Useful for"/"Great for" bullet filler, "Common Usage Patterns" and "Advanced Use Cases" ("Combining Multiple Searches" duplicates "Research on a Topic") re-demonstrate flag combinations already documented, and the closing "Resources" section re-summarizes the script's features yet again. Not a 3 because the redundancy goes beyond minor tightening — well over half of the second half of the file could be deleted with no loss; not a 1 because it avoids explaining concepts Claude already knows and most lines are concrete commands.

2 / 5

Actionability

Every capability is shown as a copy-paste-ready command (e.g., `python scripts/search.py "climate change" --type news --time-range w --max-results 15`), all 13 documented flags exist in the actual script's argparse, sample outputs for all three formats are shown, installation is given, and troubleshooting covers concrete failure modes. Fully executable with common cases covered — matches the top anchor.

5 / 5

Workflow Clarity

The "Implementation Approach" section lays out a clear 5-step sequence (identify intent → configure parameters → select format → execute → process results), and Troubleshooting supplies error-recovery feedback ("No results found: Try broader search terms or remove time filters", retry after timeouts, space out rate-limited requests). Not a 5 because these recovery loops live in a separate section rather than being integrated as checkpoints in the workflow itself; well above a 3 since sequence and recovery guidance are both explicit.

4 / 5

Progressive Disclosure

The body is well-sectioned with headers and a Quick Reference, and its single bundle file (scripts/search.py) is real, correctly referenced, and consistently used. However, everything is inlined in one ~514-line SKILL.md: the per-filter option catalogs, the usage-pattern cookbook, and the script-feature summary are content that could live in a references/ file or be delegated to the script's own --help, which the doc itself points to. Structure exists, but content that should be separate is inline — matches the middle anchor.

3 / 5

Total

14

/

20

Passed

Description

83%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 that clearly states capability (DuckDuckGo-backed web, news, image, and video search with text/markdown/JSON output) and gives explicit, natural-language trigger guidance. Trigger terms and concrete actions are well chosen; only minor gaps in capability coverage and a slight overlap risk around broad terms like "research" keep it from full marks.

DimensionReasoningScore

Specificity

Lists several concrete actions — "search the web for information, find current content, look up news articles, search for images, or find videos" and "return results in clean, formatted output (text, markdown, or JSON)" — with minor gaps (filtering, region, and output-to-file capabilities are not mentioned). Not a 5 because coverage is not comprehensive, and not a 3 because far more than 1-2 actions are named.

4 / 5

Completeness

Explicitly answers both questions: what it does ("uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON)") and when to use it ("This skill should be used when users need to..." plus "Use for research, fact-checking, finding recent information, or gathering web resources"). Clear 'what' and explicit 'when' with concrete trigger phrases matches the top anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "search the web", "look up news articles", "search for images", "find videos", "fact-checking", "research", "gathering web resources" — phrases users would actually say. Not a 5 because common variations like "search online", "look this up", or "google it" are absent; not a 3 because multiple synonyms and content types are covered well beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

The DuckDuckGo web/news/image/video search niche is mostly distinct with clear triggers. Not a 5 because broad phrases like "research", "fact-checking", and "gathering web resources" create minor overlap risk with dedicated research or verification skills; well above a 3 since the core triggers (web search, news, images, videos) are unambiguous.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (520 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
UnicomAI/wanwu
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.