searxng-search

Name: searxng-search
Rating: 68 (1 reviews)
Author: YPares

tessl install github:YPares/agent-skills --skill searxng-search

github.com/YPares/agent-skills

Enhanced web and package repository search using local SearXNG instance

Review Score

68%

Validation Score

11/16

Implementation Score

85%

Activation Score

33%

SKILL.md

Review

Evals

Generated

4 days ago

Warnings & errors only

Criteria	Score
description_trigger_hint	Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...')
metadata_version	'metadata' field is not a dictionary
license_field	'license' field is missing
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata
body_steps	No step-by-step structure detected (no ordered list); consider adding a simple workflow

Overall Assessment

This is a well-structured, highly actionable skill with excellent executable examples and clear organization. The main weakness is some verbosity - the manual container start section and extensive PyPI workaround could be moved to reference files to keep the main skill leaner. The progressive disclosure and workflow clarity are strong.

Suggestions

Move the 'Manual Container Start' and 'Advanced Config' sections to a separate CONFIGURATION.md reference file to reduce main skill length
Consider moving the PyPI Workaround section to the referenced pypi-direct-search.md file and just link to it with a brief note

Dimension	Score	Reasoning
Conciseness	2/3	The skill is reasonably efficient but includes some redundant information (e.g., explaining what SearXNG is, repeating similar curl patterns multiple times). The PyPI workaround section and manual container start section add bulk that could be in referenced files.
Actionability	3/3	Excellent executable examples throughout - all curl commands are copy-paste ready with proper jq filtering, the start-searxng commands are concrete, and the Nushell integration provides complete working code.
Workflow Clarity	3/3	Clear start/stop workflow with explicit commands. The quick reference table provides unambiguous task-to-command mapping. Debugging section provides validation steps for troubleshooting. For this type of search tool skill, the workflow is appropriately simple and clear.
Progressive Disclosure	3/3	Well-structured with Quick Start at top, Quick Reference table for common tasks, then progressively more detailed sections. References external files appropriately (package-engine-status.md, pypi-direct-search.md) with clear signaling.

Overall Assessment

The description identifies the core capability (search via SearXNG) but is too brief and lacks explicit usage triggers. It fails to specify concrete actions users might request and doesn't include a 'Use when...' clause, making it difficult for Claude to know when to select this skill over alternatives.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when the user asks to search the web, look up packages, find documentation, or mentions searching online'
List specific concrete actions such as 'search web pages, query package repositories (npm, pip, crates), find documentation, look up library versions'
Include natural user terms like 'search online', 'find', 'look up', 'google this', and specific package manager names

Dimension	Score	Reasoning
Specificity	2/3	Names the domain (web and package repository search) and the tool (SearXNG), but doesn't list specific concrete actions like 'search documentation', 'find packages', or 'query APIs'.
Completeness	1/3	Describes what it does at a high level but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.
Trigger Term Quality	2/3	Includes 'web search', 'package repository', and 'SearXNG' which are relevant, but misses common user terms like 'search online', 'find', 'look up', 'google', or specific package managers like 'npm', 'pip'.
Distinctiveness Conflict Risk	2/3	The mention of 'SearXNG' and 'package repository' provides some distinction, but 'web search' is generic and could overlap with other search-related skills.