CtrlK
BlogDocsLog inGet started
Tessl Logo

webshop-product-search

Performs an initial product search using a web interface by generating appropriate search keywords based on interpreted query criteria. Use when starting a product discovery task, when returning to search results after rejecting a product, or when the observation contains a search interface prompt. The skill inputs structured search parameters and outputs a list of candidate products from the search results page.

71

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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 compact, well-structured skill body for a simple single-purpose task: it gives the exact action syntax, a validated four-step workflow with error-recovery loops, and a concrete worked example, all with essentially no padding. The only improvement space is removing slight redundancy between the Constraints section, the trigger bullets, and earlier steps.

DimensionReasoningScore

Conciseness

The body is tight and environment-specific (e.g., "Use the `search[keywords]` action... Keywords must be a single string enclosed in brackets", "Success is marked by a 'Page 1' observation"), with no explanations of concepts Claude already knows. It falls just short of the lean/5 anchor because of minor repetition — the "Do not include multiple actions or extra formatting in the search keywords" constraint restates guidance from step 3, and the Trigger Condition bullet duplicates the frontmatter's trigger clause.

4 / 5

Actionability

Guidance is fully executable for the target environment: the exact action format `search[long clip-in hair extension]`, the criteria-extraction breakdown (product_type, attributes, budget), and the concrete query-formulation rule ("Prioritizes core product type and key attribute"). The worked trajectory example covers the common case copy-paste ready.

5 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with an explicit validation checkpoint ("Validate Results: Success is marked by a 'Page 1' observation") and error-recovery feedback loops for both failure modes ("If 0 results are returned, re-invoke with a broader or alternative query. If all results exceed the user's price constraint, refine with additional terms"). This matches the top anchor's validate → fix → retry pattern.

5 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, with no bundle files needed and no external references; content is organized into well-labeled sections (Core Workflow, Key Decision Logic, Constraints, Example from Trajectory) that make navigation trivial. Per the rubric's simple-skill guidance, this warrants the top score.

5 / 5

Total

19

/

20

Passed

Description

80%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 strong description that clearly and explicitly states both what the skill does and when to use it, with a well-defined niche as the entry point of a product-discovery pipeline. Its main weakness is trigger vocabulary that is environment-internal ("observation", "search interface prompt") rather than phrased in natural user language, slightly limiting keyword coverage.

Suggestions

Add natural, user-facing trigger terms (e.g., "find products", "shop for items", "browse search results") alongside the environment-specific ones in the 'Use when...' clause.

Replace or gloss internal jargon like "the observation contains a search interface prompt" with plainer wording (e.g., "when the current page shows a search box or a 'Back to Search' button") so the trigger reads naturally.

DimensionReasoningScore

Specificity

The description names several concrete actions — "Performs an initial product search", "generating appropriate search keywords based on interpreted query criteria", "inputs structured search parameters and outputs a list of candidate products" — which matches the 'lists several specific actions; minor gaps' anchor. It is not a 5 because coverage is narrow (a single search action and its I/O) without additional variations such as query refinement or retry handling.

4 / 5

Completeness

It explicitly answers both: what ("Performs an initial product search... generating appropriate search keywords... outputs a list of candidate products") and when ("Use when starting a product discovery task, when returning to search results after rejecting a product, or when the observation contains a search interface prompt") with three concrete trigger conditions. This matches the anchor for clearly and explicitly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

Phrases like "product discovery task", "returning to search results", and "search interface prompt" are relevant, but the vocabulary leans on environment jargon ("observation", "search interface prompt") and misses natural user-facing variations like "find products", "shop for", or "browse items". Not a 4 because common synonyms a user would actually say are absent; not a 2 because several domain-relevant keywords are present.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — the initial/entry search step of a web shopping pipeline — with triggers tied to starting a discovery task or re-entering the search page, minimizing overlap with downstream evaluation/filtering skills. This matches the 'clear niche with distinct triggers' anchor.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
zjunlp/SkillNet
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.