webshop-initial-search

Performs the first search on an e-commerce platform using keywords derived from parsed user requirements. Use when starting product discovery from a user instruction or when previous search results are insufficient and a new query is needed. It formulates a search query from the criteria (e.g., '24 pack of 7.5 ounce bottles of non-gmo classic tonic') and executes the search[] action, returning the initial result page.

Quality

92%

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

Quality

Content

92%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.

A tight, actionable skill body with a concrete worked example and a clear step sequence. Only minor conciseness improvements are warranted; structure and executability are strong.

Suggestions

Tighten 'Prioritize specificity to filter results effectively.' and merge the 'Next Steps' guidance into the Execute step to reduce token overhead.

Consider noting what to do when no results match (refinement path) to make the workflow's failure branch explicit.

Dimension	Reasoning	Score
Conciseness	Mostly lean and actionable, but a few phrases ('Prioritize specificity to filter results effectively') and the somewhat redundant 'Next Steps' section could be trimmed.	4 / 5
Actionability	Provides a fully executable, copy-paste-ready example action `search[24 pack of 7.5 ounce bottles of non-gmo classic tonic]` that demonstrates the exact platform syntax for the common case.	5 / 5
Workflow Clarity	The four steps (parse, formulate, execute, next steps) are clearly sequenced; since this is a read-only search (not destructive or batch), the validation cap does not apply and the single action is unambiguous.	5 / 5
Progressive Disclosure	A short single-purpose skill under 50 lines with no external references needed; the Instructions and Example sections are well organized, satisfying the simple-skill exception.	5 / 5
	Total	19 / 20 Passed

Description

92%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.

A well-crafted description that clearly states the skill's purpose, its concrete actions, and explicit trigger conditions in third-person voice. Only minor keyword-coverage gaps prevent a perfect trigger-term score.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Performs the first search', 'formulates a search query', 'executes the search[] action', 'returning the initial result page' — giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Explicitly answers both 'what' (performs the first search, formulates a query, executes the search action, returns the result page) and 'when' with a concrete 'Use when...' trigger clause.	5 / 5
Trigger Term Quality	Natural trigger phrases like 'starting product discovery from a user instruction' and 'previous search results are insufficient and a new query is needed' are present, but a few common synonyms (e.g., 'shopping', 'browse') are missing.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche — the initial e-commerce search — with distinct triggers ('first search', 'previous search results are insufficient'), minimizing overlap with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: zjunlp/SkillNet
Path: experiments/src/skills/webshop/webshop-initial-search/SKILL.md
Commit: cce11c3

Reviewed: 2 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.