CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

61

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./experiments/src/skills/webshop/webshop-search-constructor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is concise, well-structured, and gives a clear end-to-end workflow with a concrete example. However, it delegates all query construction to a script that is missing from the bundle, and it fails to link the one reference file that exists — leaving the reader with executable-looking but actually broken guidance and no discoverable fallback.

Suggestions

Bundle the referenced `scripts/construct_search_query.py` (or replace the delegation with inline construction rules) so the core instruction is actually executable.

Link `references/query_optimization_guide.md` from the body (e.g., under an "Advanced" or "Manual construction" section) so the existing reference is discoverable and can serve as a fallback.

Add a brief fallback/validation note: what to do if the script is unavailable or returns unexpected output (e.g., apply the guide's ordering and formatting rules manually).

DimensionReasoningScore

Conciseness

The body is lean (~24 lines): a three-step core process, one worked example, and three short notes — no explanations of concepts Claude already knows and no padding. The only near-redundancy ("Always delegate query construction to the bundled script" restating step 2) is minor, keeping it at the every-token-earns-its-place anchor rather than dropping to 4.

5 / 5

Actionability

The guidance includes a concrete, copy-paste-ready command ("python scripts/construct_search_query.py --product \"jewelry box\" --attributes \"10 slots\" \"easy to clean\" --price-limit 60.00") plus expected output — but the referenced script does not exist anywhere in the bundle, so the delegation instruction cannot actually be executed. This is a critical missing key detail rather than a minor gap, which places it at the incomplete-guidance anchor (3) rather than 4; the concrete command form keeps it above the high-level-hints level of 2.

3 / 5

Workflow Clarity

"Receive Criteria → Construct Query → Execute Action" is a clear, unambiguous sequence with a fully worked end-to-end example and an explicit output syntax ("search[<constructed_query>]"). No validation checkpoint is needed for a non-destructive single query, but there is no guidance for handling script failure or unexpected output, which keeps it below 5; it clearly exceeds the implicit-checkpoint level of 3.

4 / 5

Progressive Disclosure

The body itself is well-organized into clear sections, but scored against the actual bundle: it references a `scripts/construct_search_query.py` path that does not exist, while the provided `references/query_optimization_guide.md` (which contains the query-construction principles needed to do the task) is never mentioned or linked — a buried reference. This matches the some-structure/references-not-clearly-signaled anchor (3); it avoids 2 only because the body sections are clean and nothing bulky is wrongly inlined.

3 / 5

Total

15

/

20

Passed

Description

75%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: it explicitly states what the skill does, when to use it, and concretely shows both input and output formats. The 'when' clause and trigger-term coverage could be slightly richer with user-facing synonyms and phrases, but there is no vague fluff and the third-person voice is consistent.

Suggestions

Expand the 'when' clause with concrete user trigger phrases (e.g., "Use when the user asks to find, search for, or shop for a product on an e-commerce site").

Add a few natural synonyms such as "online store", "shop for", or the specific platform name to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"formulates an effective search query", "converting attributes into a concise, relevant keyword string", and a concrete input/output pair ("'jewelry box', '10 slots'..." → "search[...]") name several specific actions with minor gaps in coverage. Not a 5 because it describes essentially one transformation rather than multiple comprehensively covered actions; not a 3 because the input/output examples make the actions far more concrete than the 1-2 action anchor.

4 / 5

Completeness

Both are answered: what — "formulates an effective search query... converting attributes into a concise, relevant keyword string" with explicit input and output; when — "It is used when initiating a product search on an e-commerce platform". Not a 5 because the 'when' is a single scenario rather than concrete user trigger phrases (e.g., "when the user asks to find or shop for a product"); it clearly exceeds the weak-or-missing-'when' level of 3.

4 / 5

Trigger Term Quality

Natural terms like "product search", "e-commerce platform", "search query", and concrete product examples ("jewelry box", "price") give good keyword coverage. Missing common variations and synonyms ("shop for", "find a product", "online store", specific platform names) keeps it below the comprehensive-synonym anchor at 5, but it is well above the sparse-keyword level of 3.

4 / 5

Distinctiveness Conflict Risk

The niche — converting parsed criteria into a platform `search[...]` action string — is distinctive and unlikely to trigger for unrelated skills. Minor overlap risk with general e-commerce browsing/shopping skills keeps it below the minimal-conflict anchor at 5, but it is far more distinct than the somewhat-specific anchor at 3.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

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.