duckduckgo-search
Performs web searches using DuckDuckGo to retrieve real-time information from the internet. Use when the user needs to search for current events, documentation, tutorials, or any information that requires web search capabilities.
72
66%
Does it follow best practices?
Impact
75%
3.57xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./public/skills/10e9928a/duckduckgo-search/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description that clearly communicates its purpose and when to use it. The explicit 'Use when' clause with natural trigger terms makes it easy for Claude to select appropriately. The main weakness is that the specificity of capabilities could be improved by listing more concrete actions beyond just 'performs web searches' and 'retrieve real-time information'.
Suggestions
Add more specific concrete actions to improve specificity, e.g., 'Performs web searches using DuckDuckGo to retrieve real-time information, find documentation links, look up recent news, and answer factual questions about current topics.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (web searches via DuckDuckGo) and the general action (retrieve real-time information), but doesn't list multiple specific concrete actions beyond searching—e.g., no mention of summarizing results, following links, extracting snippets, or comparing sources. | 2 / 3 |
Completeness | Clearly answers both 'what' (performs web searches using DuckDuckGo to retrieve real-time information) and 'when' (explicit 'Use when' clause covering current events, documentation, tutorials, or any information requiring web search). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'web search', 'search', 'current events', 'documentation', 'tutorials', 'DuckDuckGo', and 'internet'. These cover a good range of how users naturally phrase search requests. | 3 / 3 |
Distinctiveness Conflict Risk | The mention of DuckDuckGo and web search creates a clear, distinct niche. It's unlikely to conflict with other skills since web searching via a specific engine is a well-defined capability. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable with excellent, executable code examples covering every search type, but it is far too verbose for a SKILL.md file. It reads more like comprehensive library documentation than a concise skill instruction, with extensive parameter tables, seven search type examples, utility scripts, and troubleshooting all crammed into a single file. Claude already knows how to use Python libraries and doesn't need this level of API documentation detail.
Suggestions
Reduce the SKILL.md to a quick-start section with one text search example and a parameter quick-reference, moving the 7 search type examples and utility scripts to a separate REFERENCE.md file.
Remove the feature list, installation troubleshooting, and general advice (privacy, copyright) that Claude already knows or that don't add actionable value.
Add explicit validation steps for batch operations (e.g., check for empty results, retry logic on DuckDuckGoSearchException) to improve workflow robustness.
Structure as overview + references: keep only text search and one advanced example inline, link to separate files for images/videos/maps/news search types and utility scripts.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose - the skill exhaustively documents every search type (text, news, images, videos, instant answers, suggestions, maps) with full code examples, plus utility scripts, parameter tables, FAQ, proxy setup, and integration notes. Much of this is API documentation that Claude could infer from the library. The feature list with emojis, the 'privacy-friendly' marketing language, and installation troubleshooting are unnecessary padding. | 1 / 3 |
Actionability | All code examples are fully executable, copy-paste ready Python snippets with concrete parameters, output formatting, and real usage patterns. Error handling, proxy configuration, and batch search examples are all concrete and runnable. | 3 / 3 |
Workflow Clarity | The batch search example includes a rate-limiting delay (time.sleep(1)), and error handling is shown, but there's no validation/verification step for batch operations (e.g., checking if results are empty, retrying on failure). The integration section with browser-use shows a two-step workflow but lacks explicit validation between steps. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of content (~300+ lines) with everything inline. The seven search types, utility scripts, parameter reference tables, FAQ, and integration examples should be split into separate reference files. There's no layering - quick start and exhaustive API reference are all in one document. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
- Repository
- Demerzels-lab/elsamultiskillagent
- Commit
45f9fac
- 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.