CtrlK
BlogDocsLog inGet started
Tessl Logo

web-search

Web search and research specialist for finding and synthesizing information

55

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./crates/openfang-skills/bundled/web-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The body is concise and well-structured, providing sensible research guidance without padding. Its main weakness is actionability and workflow clarity: tactics are described at a high level with no executable examples and no explicit sequenced workflow with verification steps.

Suggestions

Add a concrete, sequenced research workflow (e.g., 1. Formulate query → 2. Run search → 3. Evaluate sources → 4. Synthesize with citations) with an explicit verification/check step for source corroboration.

Include at least one executable example, such as a sample query string demonstrating quoted phrases plus a site: operator for a real scenario.

Tighten the Pitfalls section into the workflow as validation checkpoints rather than a separate advisory list.

DimensionReasoningScore

Conciseness

The body is a lean set of bulleted principles and tactics with no padding and no explanation of concepts Claude already knows; every section earns its place.

3 / 3

Actionability

It offers concrete tactics (quoted exact phrases, 'site:docs.python.org', including the current year, version numbers) but no executable code or copy-paste-ready commands, leaving guidance at the tactic level rather than fully actionable.

2 / 3

Workflow Clarity

Content is organized into topical sections (Search Techniques, Synthesizing Results) that imply a rough flow, but there is no explicit step sequence or validation checkpoints for the multi-step research process.

2 / 3

Progressive Disclosure

The skill is under 50 lines, single-purpose, and has no external references; the body is well-organized into clearly headed sections, satisfying the simple-skill allowance for a top score.

3 / 3

Total

10

/

12

Passed

Description

50%

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 correctly uses third-person voice and identifies a clear niche, but it reads as a generic capability statement rather than a trigger-rich declaration. It tells what the skill does without specifying when Claude should invoke it.

Suggestions

Add an explicit 'Use when...' clause naming concrete triggers (e.g., 'Use when the user asks to look something up online, research a topic, or find current information').

Replace abstract actions with concrete capabilities, e.g., 'formulate search queries, evaluate sources, and synthesize findings into cited answers'.

Include natural trigger variations users would actually say ('search the web', 'look up', 'find online') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('web search and research specialist') and two actions ('finding and synthesizing information'), but the actions are abstract rather than the multiple concrete, specific actions the top anchor requires.

2 / 3

Completeness

It states what the skill does but lacks any 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 2 per the judging guidelines.

2 / 3

Trigger Term Quality

Contains natural terms a user might say ('web search', 'research') but offers limited coverage and misses common variations like 'look up', 'find online', or 'search the web'.

2 / 3

Distinctiveness Conflict Risk

'Web search' is a reasonably clear niche, but 'research' and 'finding information' are broad enough to overlap with other skills, and the absence of distinct triggers keeps it from the top anchor.

2 / 3

Total

8

/

12

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
RightNow-AI/openfang
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.