Index of every page on this site: llms.txt
All skills
google avatar

/product-search

@ead8d7f
by googlegoogle/adk-recipes11k stars
2,961
Run it yourself

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.

  • 28 files
  • 586.9 KB
  • Updated 2 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/google/adk-recipes/product-search

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesinstall-paths.md

≈475 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Install Paths and Environment Quirks

Known install dirs per host

Host Install dir
Claude Code ~/.claude/skills/<skill-name>/
npx skills add (Codex, Gemini CLI, GitHub Copilot, others) ~/.agents/skills/<skill-name>/
Gemini CLI standalone ~/.gemini/skills/<skill-name>/
Cursor ~/.cursor/skills/<skill-name>/

bootstrap.sh tries these paths in order. If your host installs elsewhere, set SKILL_DIR manually:

export SKILL_DIR=/path/to/your/install/dir

Python interpreter fallback

bootstrap.sh tries command -v python3.{13,12,11,10} first, then falls back to absolute paths (/opt/homebrew/bin/, /usr/local/bin/, ~/.pyenv/shims/). The fallback handles sandboxed shells with stripped PATH.

For conda/asdf/other layouts, set PYTHON_BIN and skip the loop.

Why bash -c wraps the pip command

SKILL_DIR may contain spaces (/Users/name with space/.claude/skills/...). bash -c "pip install -e '$SKILL_DIR'" quotes the whole argument so pip sees one path, not tokens split at spaces.

(Historical note: earlier versions installed pip install -e "$SKILL_DIR[adk]" to pull an optional ADK extra. google-adk is now an unconditional dependency in pyproject.toml, so the [adk] selector is no longer needed. If you see it in a stale doc, drop the [adk] suffix and the install still works.)

Why the workspace setup must run as one shell command

Agent shell tools reset cwd and clear variables between calls. If you set SKILL_DIR in call 1 and run pip in call 2, $SKILL_DIR is empty in call 2 and the install becomes pip install -e (invalid).

Description tuning for triggering

If your skill is registered but the agent doesn't pick it for relevant prompts, the description field is what hosts' routers match against. Include concrete trigger phrases alongside the abstract description.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at ead8d7f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 2 months ago
metadata
{
  "author": "Google",
  "license": "Apache-2.0",
  "version": "0.2.0"
}

README badge

README badge for google/adk-recipes/product-search