CtrlK
BlogDocsLog inGet started
Tessl Logo

webshop-result-analyzer

This skill evaluates a list of search results against the target product criteria. Trigger it when a search result page is observed, to identify promising product listings. It analyzes each result's title, price, and brief description to shortlist items that best match the required attributes (like size, color, and price), outputting a prioritized list of candidate product IDs or links for further inspection.

60

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./experiments/src/skills/webshop/webshop-result-analyzer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 excellently concise and well-sectioned, but it is functionally incomplete: the scoring step depends on a bundled script that is absent from the bundle, the output-format section cuts off mid-sentence, and the existing reference files are never linked. A user following it verbatim cannot complete the workflow.

Suggestions

Complete section 4: the body ends at 'Present the analysis in this format:' with no format shown — add the concrete output template (e.g., ranked Product ID list with match score and price) the step promises.

Fix the script dependency: either add 'scripts/analyze_results.py' with its invocation command and arguments shown inline, or replace step 3 with inline deterministic scoring rules so the step is executable without a missing file.

Wire up the real bundle files: link 'references/attribute_patterns.md' from the attribute-matching step (it already contains the regex patterns the body alludes to) and complete or remove the truncated 'references/execution_example.md' stub so no dangling or dead references remain.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: every section is a terse instruction ('Convert any range... to its maximum value for comparison against the budget') with no explanation of concepts Claude already knows and no padding. Matches the 'every token earns its place' anchor exactly.

5 / 5

Actionability

Parsing guidance is concrete (the '[ASIN/Product ID] [SEP] [Title] [SEP] [Price Range]' format, price-range conversion rule, textual-match criteria), but the pivotal step 3 says to run the bundled script 'analyze_results.py' which does not exist in the bundle, with no invocation command, arguments, or fallback, and step 4's output format is missing entirely ('Present the analysis in this format:' with nothing following). Incomplete executable guidance with missing key details matches the 3 anchor; not 4 because the core execution step cannot be carried out as written.

3 / 5

Workflow Clarity

A clear four-section sequence exists (extract requirements, analyze results, score, output), but the workflow is incomplete: the final step is truncated mid-instruction, the script dependency is broken, and this batch operation over many listings has no validation or feedback loop, capping the score at 3 per the rubric's batch-operation guideline. Not 2 because the sequence is well-defined rather than rough with many gaps.

3 / 5

Progressive Disclosure

Sections are well-organized and the skill is short, but scored against the actual bundle: the body references a nonexistent 'scripts/analyze_results.py' while never linking the two real reference files ('references/attribute_patterns.md', 'references/execution_example.md'), one of which ('execution_example.md') is itself a truncated stub. Structure exists but references are neither signaled nor intact, matching the 3 anchor; not 2 because nothing bulky is inlined that belongs in a separate file.

3 / 5

Total

14

/

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.

The description is a strong, third-person, two-part statement that clearly conveys both capability and trigger condition with concrete inputs and outputs. It sits just below the top anchors due to a single general trigger condition and limited synonym coverage.

DimensionReasoningScore

Specificity

Lists several concrete actions ('evaluates a list of search results', 'analyzes each result's title, price, and brief description', 'shortlist items', 'outputting a prioritized list of candidate product IDs') with named attributes (size, color, price). Not 5 because coverage has minor gaps (scoring mechanics and target environment are unstated); not 3 because far more than 1-2 actions are specified.

4 / 5

Completeness

Both 'what' (evaluates, analyzes, shortlists, outputs prioritized candidates) and 'when' ('Trigger it when a search result page is observed') are explicitly stated in third person. Not 5 because the trigger guidance is a single general condition without concrete trigger cues (e.g., the WebShop environment or specific page markers); not 3 because 'when' is explicit, not merely implied.

4 / 5

Trigger Term Quality

Natural terms users would say are present ('search result page', 'search results', 'product listings'), giving good keyword coverage. Not 5 because common variations and synonyms (e.g., 'results page', 'shopping results', 'product search') are missing; not 3 because the included keywords are directly relevant rather than partial.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (e-commerce product search-result filtering and shortlisting) with distinct triggers, so it is mostly distinguishable. Not 5 because 'search result page' has minor overlap risk with generic web-search or shopping-assistant skills; not 3 because the domain and output (candidate product IDs) are specific.

4 / 5

Total

16

/

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.