CtrlK
BlogDocsLog inGet started
Tessl Logo

web-search

Real-time web search using Playwright-controlled browser. Use this skill when you need current information, latest documentation, recent news, or any data beyond your knowledge cutoff (January 2025).

57

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

Quality

Content

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

Highly actionable and well-structured for finding information, with executable commands and genuinely useful error-recovery flows. The dominant problems are severe duplication (four overlapping example sections) and near-zero progressive disclosure — everything is inlined in a very long SKILL.md while the few external references point to files that don't exist in the bundle.

Suggestions

Collapse 'Examples of when to use', 'Common Patterns', 'Workflow Example', and 'Examples for Claude' into one example set, and merge 'Best Practices' with 'Tips for Effective Use' and 'Error Handling' with 'Troubleshooting Guide' — this alone would roughly halve the file.

Move the direct curl API reference, the troubleshooting tables, and the extended examples into reference files (e.g., references/api.md, references/troubleshooting.md) and point to them from SKILL.md, per the progressive-disclosure rubric.

Fix the inconsistent path forms: replace every `bash SKILLs/web-search/scripts/...` occurrence with the `bash "$SKILLS_ROOT/web-search/scripts/..."` form used in Basic Usage, and remove or correct references to nonexistent files (README.md, examples/basic-search.md, dist/server/index.js).

DimensionReasoningScore

Conciseness

The ~560-line body is heavily padded: essentially the same usage examples appear four times ("Examples of when to use", "Workflow Example", "Common Patterns" with 5 patterns, and "Examples for Claude" with 5 more), "Best Practices" duplicates "Tips for Effective Use", and "Error Handling" duplicates "Troubleshooting Guide". Most content is skill-specific rather than concepts Claude already knows, which keeps it above anchor 1, but it squarely matches anchor 2's 'several unnecessary explanations or padded sections' — if anything it approaches anchor 1.

2 / 5

Actionability

Mostly executable, copy-paste-ready commands: `bash "$SKILLS_ROOT/web-search/scripts/search.sh" "query" 5`, direct curl calls to the bridge API, and concrete error strings with fixes, and the referenced scripts (search.sh, start-server.sh, stop-server.sh, test-basic.js) all exist in the bundle. It falls short of anchor 5 because several commands use a broken path form (`bash SKILLs/web-search/scripts/search.sh` — no variable expansion, wrong casing) in the Common Patterns, Error Handling, and Troubleshooting sections.

4 / 5

Workflow Clarity

The core workflow is clearly sequenced (search → parse/synthesize → follow-up search) and the error paths provide real feedback loops (server not running → start-server.sh; timeout → stop → clear .connection → restart; a Quick Diagnostics sequence; a full-reset recipe). It does not reach anchor 5 because the primary workflow has no explicit verify/validate checkpoint, and the inconsistent path styles create gaps in the recovery steps.

4 / 5

Progressive Disclosure

Section structure is good and the scripts are real, but ~560 lines are inlined monolithically in SKILL.md — the curl API reference, the troubleshooting tables, and 15 example blocks are all content that clearly belongs in separate reference files. Additionally, the 'Additional Resources' and 'File Locations' sections point to `SKILLs/web-search/README.md`, `examples/basic-search.md`, and `dist/server/index.js`, none of which exist in the bundle — dead references. This matches anchor 3 ('content that should be separate is inline') and does not reach anchor 4's 'references mostly clear' given the broken ones.

3 / 5

Total

13

/

20

Passed

Description

77%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 well-constructed trigger-oriented description that clearly answers both 'what' and 'when' with natural user phrases. Its weaknesses are thin action coverage (only 'search' is named) and second-person voice ("when you need"), which the rubric penalizes.

Suggestions

Rewrite the 'when' clause in third person (e.g., "Use when the user asks for current information, recent news, or anything past the knowledge cutoff") to avoid the second-person voice penalty.

Add one or two more concrete capability phrases (e.g., "returns titled results with URLs and snippets") so the 'what' half names more than a single action.

DimensionReasoningScore

Specificity

The description names the domain and a single concrete action — "Real-time web search using Playwright-controlled browser" — matching anchor 3's level of coverage, but it uses second-person voice ("Use this skill when you need current information"), which the rubric explicitly penalizes by reducing the specificity score by 1. The result lands on anchor 2: the domain is named but the action coverage is minimal.

2 / 5

Completeness

It explicitly answers both questions: what ("Real-time web search using Playwright-controlled browser") and when ("Use this skill when you need current information, latest documentation, recent news, or any data beyond your knowledge cutoff (January 2025)"), with concrete trigger phrases — a direct match for anchor 5. It is not anchor 4 because the 'when' clause is already explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Phrases like "current information", "latest documentation", "recent news", and "data beyond your knowledge cutoff" are natural things users say when they need this skill, giving good keyword coverage. A few common variations are missing (e.g., "search the web", "look this up online", "up-to-date"), so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Web search for post-cutoff information is a clear, well-bounded niche with distinct triggers ("knowledge cutoff", "recent news", "latest documentation"), minimizing the chance it fires for the wrong skill. There is no evidence of overlap with other skills, so it does not fall to anchor 4's 'minor overlap risk'.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
netease-youdao/LobsterAI
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.