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.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./src/opensquilla/skills/bundled/web-search/SKILL.md

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 with complete, executable commands but is significantly over-long and monolithic for a single-script skill, inlining material that would be better split into reference files. Verbosity and lack of file-based progressive disclosure are the main weaknesses.

Suggestions

Trim redundant sections (e.g., merge 'Common Usage Patterns' and 'Advanced Use Cases', drop 'Useful for'/'Great for' filler bullets) to roughly halve the body length and respect Claude's token budget.

Move the exhaustive option reference and output-format examples into a separate reference file (e.g., references/REFERENCE.md) and link to it from a concise quick-start overview, enabling one-level-deep progressive disclosure.

Collapse the per-flag command examples into a single compact options table plus one or two representative end-to-end examples instead of repeating the base command for every flag.

Dimension	Reasoning	Score
Conciseness	The ~510-line body is noticeably verbose for a single-command CLI skill, padding each option with redundant examples plus 'Useful for'/'Great for' bullet lists and largely overlapping 'Common Usage Patterns' and 'Advanced Use Cases' sections, though it stops short of explaining concepts Claude already knows.	2 / 5
Actionability	Fully executable, copy-paste-ready commands appear throughout with concrete examples covering web/news/images/videos searches and all major flags, matching the 'copy-paste ready, common cases covered' anchor.	5 / 5
Workflow Clarity	The 'Implementation Approach' lays out a clear identify-configure-select-execute-process sequence and the single search action is unambiguous; being a read-only skill it needs no validation checkpoints, so it lands at 4 rather than 5 due to light redundancy with the workflow framing.	4 / 5
Progressive Disclosure	The bundle is only scripts/search.py and the documentation is a monolithic 510-line SKILL.md that inlines exhaustive option references, output-format examples, usage patterns, and advanced cases that could live in separate reference files; section headers provide some structure but content that should be split out is inline.	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.

The description is strong: it clearly states what the skill does and when to use it with concrete, natural trigger phrases and good capability specificity. It is comprehensive on completeness and only slightly short of maximum on trigger synonym coverage and distinctiveness.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('search the web for information', 'look up news articles', 'search for images', 'find videos', 'return results in formatted output') with only minor gaps in coverage, fitting the 'several specific actions' anchor rather than the fully comprehensive level 5.	4 / 5
Completeness	Explicitly answers both 'what' ('uses DuckDuckGo's search API to return results in formatted output') and 'when' ('This skill should be used when users need...', 'Use for research, fact-checking...') with concrete trigger phrases, in third person.	5 / 5
Trigger Term Quality	Good natural keyword coverage with phrases users actually say ('search the web', 'look up news articles', 'fact-checking', 'research'), but a few common synonyms are missing, so it sits at 4 rather than 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear web-search niche with distinct triggers across web/news/images/videos, with only minor overlap risk against other research-oriented skills.	4 / 5
	Total	17 / 20 Passed

Validation

75%

Warnings & errors only

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

Validation — 12 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (539 lines); consider splitting into references/ and linking	Warning
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	12 / 16 Passed

Repository: TokenRhythm/opensquilla
Path: src/opensquilla/skills/bundled/web-search/SKILL.md
Commit: 94ac35e

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.