webshop-search-constructor

This skill formulates an effective search query from structured product criteria. It is used when initiating a product search on an e-commerce platform, converting attributes into a concise, relevant keyword string. The input is a set of parsed criteria (e.g., 'jewelry box', '10 slots', 'easy to clean', 'price < $60'), and the output is a formatted search action string (e.g., 'search[jewelry box, 10 slots, less than $60, easy to clean]') optimized for the platform's search engine.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%

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

The body is lean, actionable, and presents an unambiguous workflow with a concrete worked example. The key weakness is progressive disclosure: it points to a bundled script that is absent, and leaves an existing reference guide orphaned and unlinked.

Suggestions

Add the missing 'scripts/construct_search_query.py' to the bundle, or replace the script delegation with inline formatting rules so the documented command actually runs.

Link the existing 'references/query_optimization_guide.md' from the body (e.g., under an 'Advanced' section) so the available reference is discoverable rather than orphaned.

Verify every path referenced in the body resolves to a real bundle file before shipping.

Dimension	Reasoning	Score
Conciseness	The ~20-line body is lean and assumes Claude's competence, avoiding explanations of what a search query is or how e-commerce works; every section earns its place, matching the lean/efficient anchor.	3 / 3
Actionability	Provides a copy-paste-ready command ('python scripts/construct_search_query.py --product "jewelry box" --attributes ... --price-limit 60.00'), its expected output, and the final 'search[...]' action format, matching the fully-executable anchor.	3 / 3
Workflow Clarity	A clear 3-step sequence (Receive Criteria -> Construct Query -> Execute Action) with a worked example; as a simple, non-destructive single-task skill, the action is unambiguous and no validation checkpoint is required, so it qualifies for 3 per the simple-skills note.	3 / 3
Progressive Disclosure	Sections are well organized, but the body delegates to 'scripts/construct_search_query.py' which does not exist as a bundle file, while the actual existing reference 'references/query_optimization_guide.md' is never linked in the body — references present but not correctly signaled and one referenced path is broken, matching the 'some structure but references not clearly signaled' anchor.	2 / 3
	Total	11 / 12 Passed

Description

85%

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 specific, complete, and distinct, with concrete input/output examples and an explicit 'when to use' trigger. Its main weakness is trigger-term naturalness: it uses structural/technical phrasing rather than the words a user would naturally say.

Suggestions

Add natural trigger terms a user would actually say (e.g., 'shopping', 'find a product', 'online store', 'product search') alongside the technical phrasing to improve trigger_term_quality.

Consider shortening the somewhat formal phrasing ('a set of parsed criteria', 'optimized for the platform's search engine') toward more direct user-facing language.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — 'formulates an effective search query', 'converting attributes into a concise, relevant keyword string' — with explicit input/output formats and examples, matching the anchor that lists multiple specific concrete actions.	3 / 3
Completeness	Clearly answers both what (formulates/converts criteria into a keyword string) and when via the explicit trigger 'It is used when initiating a product search on an e-commerce platform', so it is not capped at 2.	3 / 3
Trigger Term Quality	Includes some relevant terms ('product search', 'price limit') but leans technical ('parsed criteria', 'formatted search action string') and omits common natural variations like 'shopping', 'find a product', or 'online store', matching the 'some relevant keywords but missing common variations' anchor.	2 / 3
Distinctiveness Conflict Risk	Occupies a clear niche (e-commerce search query construction) with a distinct trigger and a unique 'search[...]' output format, making it unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: zjunlp/SkillNet
Path: experiments/src/skills/webshop/webshop-search-constructor/SKILL.md
Commit: 7bb9a48

Reviewed: 1 day 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.