CtrlK
BlogDocsLog inGet started
Tessl Logo

webshop-product-detail-navigator

Navigates to and interacts with a specific product's detail page. This skill is triggered after a candidate product ID is selected from search results. It performs the click action to load the product page and then identifies available interactive elements (like flavor or size selectors) that need to be configured to match the user's requirements.

64

Quality

75%

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-product-detail-navigator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 presents a clear, well-sequenced workflow with genuinely useful validation notes, but its execution story is undermined by a dangling script reference: the section responsible for core logic points to a `configure_product.py` that is absent from the bundle and lacks any invocation details. The existing reference file is orphaned — never linked from the body — leaving the disclosure structure inconsistent with the actual bundle.

Suggestions

Fix the dangling script reference: either bundle `scripts/configure_product.py` and document how to invoke it (command, arguments, expected output), or replace the "Key Logic (Handled by Script)" section with the actual inline decision logic for selecting flavor and size.

Link the existing reference from the body, e.g. in the Action Format section: "See [action_protocol.md](references/action_protocol.md) for the full action-response protocol", and remove the duplicated inline details to tighten conciseness.

Add an explicit fallback step to the Core Workflow for the case where no clickable matches the user's requirement (e.g., abort configuration and return to `search[<keywords>]` with refined terms), strengthening the feedback loop.

DimensionReasoningScore

Conciseness

Mostly lean — concrete examples ("smoked peppered bacon", "gluten free", "4 ounce (pack of 2)") and no explanation of concepts Claude already knows. Minor trimmable redundancy: the "When to Use" section reiterates the Purpose/description, and the "Action Format" section duplicates content already in references/action_protocol.md. Not 5 because a few tokens don't earn their place.

4 / 5

Actionability

Concrete elements exist — exact action formats ("click[<exact_value>]", "search[<keywords>]"), an example product ID ("B06Y96MXJV"), and an explicit selection order (flavor then size). However, the "Key Logic" section defers the core deterministic logic to "the bundled script `configure_product.py`" with no usage instructions (no invocation command, arguments, or path), and no such script exists in the bundle — a key missing detail that leaves the central execution path non-executable.

3 / 5

Workflow Clarity

The 5-step Core Workflow is clearly sequenced (navigate → parse → match → configure → finalize) with validation checkpoints in Important Notes ("Do not click an option if it does not appear in the current list of clickables", "Always read the full observation after each action") and an error-recovery path ("search[<keywords>] - Use only if you need to go back to search"). Not 5 because the recovery loop is thin — no guidance for what to do when no clickable matches the user's requirement before falling back to search.

4 / 5

Progressive Disclosure

Sections are well-organized for a short skill, but bundle structure is mishandled: the body's only path reference — "the bundled script `configure_product.py`" — does not exist (there is no scripts/ directory), while the one actual reference file, references/action_protocol.md, is never mentioned or linked from the body at all, and its content is partially duplicated inline. This matches "references present but not clearly signaled" rather than the mostly-clear references of score 4.

3 / 5

Total

14

/

20

Passed

Description

87%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: third-person, concrete about its actions, and explicit about both capability and trigger condition. It carves out a well-bounded niche (post-search product page configuration) with minimal overlap risk, limited only by slightly incomplete coverage of natural trigger synonyms.

DimensionReasoningScore

Specificity

Lists several concrete actions — "performs the click action to load the product page", "identifies available interactive elements (like flavor or size selectors)" to "be configured to match the user's requirements" — with only minor coverage gaps (e.g., purchase finalization is implied, not stated). Not score 3 because more than 1-2 concrete actions are named; not 5 because coverage of the full task (verification, buying) is incomplete.

4 / 5

Completeness

Explicitly answers both questions: what it does ("performs the click action to load the product page and then identifies available interactive elements... to be configured") and when to use it ("This skill is triggered after a candidate product ID is selected from search results") — a concrete, explicit trigger condition. Not 4 because the 'when' is not merely present but specific and unambiguous.

5 / 5

Trigger Term Quality

Good natural keyword coverage for the domain: "product's detail page", "product ID", "search results", "flavor or size selectors", "configure". A few natural terms are missing (e.g., "product page", "purchase options", "buy"), so it falls short of the comprehensive synonym coverage of score 5 but is well above the sparse keyword sets of score 3.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — post-search navigation and configuration of a specific product's detail page — with an explicit boundary ("triggered after a candidate product ID is selected from search results") that distinguishes it from search-phase skills. Minimal conflict risk; the triggers are distinct and domain-specific.

5 / 5

Total

18

/

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.