# Retail Product Search

Creates product search agents with semantic search and RAG on Google Cloud (Vector...

- Repository: https://github.com/google/adk-recipes (10565 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add google/adk-recipes --skill retail-product-search -g -a claude-code -y`
Codex: `npx skills add google/adk-recipes --skill retail-product-search -g -a codex -y`
Cursor: `npx skills add google/adk-recipes --skill retail-product-search -g -a cursor -y`
Gemini CLI: `npx skills add google/adk-recipes --skill retail-product-search -g -a gemini-cli -y`

## Description

Creates product search agents with semantic search and RAG on Google Cloud (Vector Search on Gemini Enterprise Agent Platform, BigQuery, embeddings). Use when the user wants to "build a product search agent", "create an e-commerce search", "make a shopping assistant", "set up semantic catalog discovery", "ingest products into Vector Search", or "deploy a retail RAG agent". Handles the full pipeline: catalog data ingestion to BigQuery, Gemini Enterprise Agent Platform Vector Search collection setup, ADK agent scaffolding, evaluation, and Cloud Run deployment.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Product Search Agent

Creates product search agents with semantic search and RAG on Google Cloud.

## STOP, Q-MODE FIRST

**If a catalog is already loaded** (system context says "DEPLOYED search agent"
or provides a `<catalog>` block), skip Q-MODE and answer product queries
directly using the catalog.

**Otherwise**, your first message MUST be exactly this:

```
[skill: retail-product-search] active.
Q-MODE: Pick a setup mode? [default: 1]
  1. Quick start -- 2 questions, smart defaults, ~60s. Best for demos and first-timers.
  2. Full setup  -- 4 questions, ~2 min. Best for real builds.
```

Then stop and wait. Accept `1`, `quick`, empty/Enter (Quick), or `2`, `full` (Full).

## Execution Rules

1. Q-MODE first. No preamble, no plan-proposing.
2. One question at a time. Show `[default: ...]`. Empty input = default.
3. Save answers to `./design-spec.md` in the workspace as you collect them.
4. After interview, run `scripts/setup.py` (see Workspace Setup below).
5. User can say "configure more" mid-Quick-Start to switch to Full.

## Workspace Setup

The skill has two locations:
- **Install dir**, where SKILL.md and scripts live (varies by host)
- **Workspace**, the agent's cwd; design-spec.md, .venv, and per-run state live here

By the end of this section the workspace must have `.venv/` (with the skill
installed editable), `design-spec.md`, and `SKILL_DIR` exported in the shell.

Run this as ONE shell command, splitting it across tool calls loses state:

```bash
SKILL_DIR=$(for d in ~/.claude/skills ~/.agents/skills ~/.gemini/skills ~/.cursor/skills; do
  [ -f "$d/retail-product-search/SKILL.md" ] && echo "$d/retail-product-search" && break
done)
bash "$SKILL_DIR/scripts/bootstrap.sh"
```

`bootstrap.sh` finds a Python 3.11+ interpreter (with absolute-path fallback
for sandboxed shells), creates `.venv`, installs the skill editable, and
copies `design-spec.md` into the workspace.

The rest: https://github.com/google/adk-recipes/blob/HEAD/plugins/retail/skills/product-search/SKILL.md