webshop-product-search git:20260307.388baa3A

Immutable. This exact content never changes and is served at /api/v1/blob/a3be6abf0af1dfc7.

---
name: webshop-product-search
description: This skill performs an initial product search using a web interface by generating appropriate search keywords based on interpreted query criteria. It is triggered when starting a product discovery task or when returning to search results. The skill inputs structured search parameters and outputs a list of candidate products from the search results page.
---
# Skill: WebShop Product Search

## Primary Function
Generate a targeted search query and execute it on a web shopping interface to retrieve a list of candidate products that match the user's criteria.

## Core Workflow
1.  **Interpret Criteria:** Analyze the user's instruction to identify key product attributes (e.g., "long clip-in hair extension", "natural looking", "price lower than 40.00 dollars").
2.  **Formulate Query:** Construct a concise, effective search string that prioritizes the most critical attributes. The primary goal is to balance specificity with recall.
3.  **Execute Search:** Use the `search[keywords]` action to submit the query.
4.  **Parse Results:** The skill's success is marked by the system returning a "Page 1" observation containing a list of products (ASINs, titles, prices).

## Key Decision Logic
*   **Query Formulation:** Start with a broad query containing the core product type. If the initial results are poor, the skill may be re-invoked with a more refined query (e.g., adding "synthetic" or "human hair" based on observed results).
*   **Trigger Condition:** This skill is the entry point for a new product discovery task. It is also the correct action when the observation contains "[SEP] Search" or "[SEP] Back to Search", indicating the agent is on a search page.
*   **Output Handoff:** The output of this skill is the search results page. Subsequent skills (e.g., `product-evaluation`) should be used to analyze individual items from this list.

## Error Handling / Edge Cases
*   If no search action is available in the current state, this skill is not applicable.
*   If the observation does not contain a clear search interface prompt, do not use this skill.
*   The search keywords must be a single string enclosed in brackets after `search[`. Do not include multiple actions or extra formatting.

## Example from Trajectory
**Instruction:** "i need a long clip-in hair extension which is natural looking, and price lower than 40.00 dollars"
**Skill Execution:**
1.  Criteria identified: `product_type="clip-in hair extension"`, `attribute="long"`, `attribute="natural looking"`, `budget="<40.00"`.
2.  Query formulated: Prioritizes core product type and key attribute -> `"long clip-in hair extension"`.
3.  Action: `search[long clip-in hair extension]`