Agent skill

Algo Ecom Search

by asgard-ai-platform in asgard-ai-platform/skills

Optimize e-commerce search relevance across the full pipeline from query understanding to result presentation.

MITAuto-check passedSales & Support

Install Algo Ecom Search

skills CLI
$ npx skills add asgard-ai-platform/skills --skill algo-ecom-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install asgard-ai-platform/skills algo-ecom-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/asgard-ai-platform/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/algo-ecom-search .claude/skills/algo-ecom-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
algo-ecom-search
GitHub stars
242
Token cost
~1.2k tokens
SKILL.md length
426 words
Files
4 (incl. references)
Skills in repo
207
Repo updated
First seen
Licence
MIT

At a glance

Optimize e-commerce search relevance across the full pipeline from query understanding to result presentation.

  • Works in 4 steps: Input Validation → Core Algorithm → Verification → …
  • The user needs to improve search quality
  • SKILL.md covers Overview, When to Use, Algorithm and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Algo Ecom Search is an agent skill from asgard-ai-platform/skills. Optimize e-commerce search relevance across the full pipeline from query understanding to result presentation. Use this skill when the user needs to improve search quality, implement query processing features, or diagnose search relevance issues — even if they say 'search results are bad', 'improve product search', or 'search relevance optimization'.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `examples/sample_scenario.md`, `references/query-pipeline.md` and `references/relevance-evaluation.md`).

It sits in Sales & Support, covering Search implementation and E-commerce operations. The repository describes itself as: 301 open-source coding agent skills across 22 domains — methodology, judgment & gotchas packaged as Claude Agent Skills for the Asgard AI Platform. The licence is MIT.

When your agent uses it

  • The user needs to improve search quality
  • Implement query processing features
  • Diagnose search relevance issues — even if they say search results are bad
  • Improve product search

Example prompts

  • “search results are bad”
  • “improve product search”
  • “search relevance optimization”
  • “/algo-ecom-search”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Input Validation
  2. Core Algorithm
  3. Verification
  4. Output

What it can do on your machine

Read from SKILL.md and the folder at commit 4e7f4f8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Algo Ecom Search loads about 1.2k tokens when it runs, and up to ~6.9k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 426 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from asgard-ai-platform/skills at commit 4e7f4f8, republished under its MIT licence (© asgard-ai-platform). 426 words, ~1,184 tokens.

Download SKILL.mdSave it as .claude/skills/algo-ecom-search/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
algo-ecom-search
description
Optimize e-commerce search relevance across the full pipeline from query understanding to result presentation. Use this skill when the user needs to improve search quality, implement query processing features, or diagnose search relevance issues — even if they say 'search results are bad', 'improve product search', or 'search relevance optimization'.
metadata.category
WP-43 電商搜尋演算法
metadata.tags
ecommerce, search, relevance, query-understanding

E-Commerce Search Relevance

Overview

E-commerce search is a pipeline: query understanding → retrieval → ranking → presentation. Each stage affects relevance. Optimization requires diagnosing WHICH stage fails, not just tuning one component. Zero-result rate, click-through rate, and add-to-cart rate are key metrics.

When to Use

Trigger conditions:

  • Diagnosing why search results don't meet user expectations
  • Implementing query processing features (spell check, synonyms, intent detection)
  • Reducing zero-result searches and improving conversion

When NOT to use:

  • For ranking algorithm design only (use e-commerce ranking skill)
  • For text relevance scoring only (use BM25)

Algorithm

IRON LAW: Search Quality Is Determined by the WEAKEST Pipeline Stage
Query understanding, retrieval, ranking, and presentation are sequential.
Perfect ranking cannot fix bad retrieval (missing products). Perfect
retrieval cannot fix bad query understanding (wrong intent). Diagnose
which stage fails FIRST before optimizing.
Phase 1: Input Validation

Audit current search: sample 100 queries by volume. For each, evaluate: query understanding (correct intent?), retrieval (relevant products in candidate set?), ranking (best products at top?), presentation (useful display?). Gate: Weakness localized to specific pipeline stage(s).

Phase 2: Core Algorithm

Query understanding: 1. Spell correction (edit distance, n-gram). 2. Synonym expansion (earbuds↔earphones). 3. Intent classification (product search vs brand search vs category browse). 4. Query rewriting (attribute extraction: "red shoes size 10" → color:red, category:shoes, size:10).

Retrieval optimization: 1. Multi-field search (title, description, brand, category, SKU). 2. Boosting strategies (title match > description match). 3. Filter vs boost (hard constraints: category, availability vs soft signals: popularity).

Result quality: 1. Zero-result fallback (relax query, suggest alternatives). 2. Faceted navigation (filters by price, brand, rating). 3. Did-you-mean suggestions.

Phase 3: Verification

Measure: zero-result rate (<5% target), CTR on first page (>30% target), NDCG on judged queries. Gate: Key metrics improve over baseline.

Phase 4: Output

Return search audit with prioritized improvements.

Output Format

json
{
  "audit": {"zero_result_rate": 0.08, "avg_ctr": 0.25, "top_failing_queries": ["earbuds wireless", "gift ideas"]},
  "recommendations": [{"stage": "query_understanding", "issue": "no_synonym_expansion", "impact": "high", "fix": "Add earbuds↔earphones synonym"}],
  "metadata": {"queries_sampled": 100, "period": "2025-Q1"}
}

Examples

Show full SKILL.md (174 more words)Show less
Sample I/O

Input: "wireles earbud" (misspelled) returns 0 results Expected: Spell correction → "wireless earbuds" → relevant products displayed. Recommendation: implement spell correction.

Edge Cases
InputExpectedWhy
Category-only query ("shoes")Browse intent, show popularNot a specific product search
Brand misspellingFuzzy brand matching"Nikee" → "Nike"
Long-tail query ("blue cotton v-neck t-shirt men XL")Attribute parsing neededMultiple structured attributes in free text

Gotchas

  • Synonym maintenance: Synonym lists need ongoing curation. "AirPods" is a brand, not a synonym for "earbuds." Wrong synonyms hurt precision.
  • Over-recall: Aggressive synonym expansion and fuzzy matching return too many irrelevant results. Balance recall (find everything) with precision (only relevant).
  • Language-specific challenges: Chinese search needs word segmentation. "皮鞋" (leather shoes) should not match "拖鞋" (slippers) despite shared "鞋".
  • Search analytics are essential: Without tracking query-level CTR, zero-result queries, and conversion rates, you're optimizing blind.
  • A/B testing search is hard: Search changes affect all queries. Some improve, some regress. Measure aggregate metrics AND stratify by query type.

References

  • For query understanding pipeline architecture, see references/query-pipeline.md
  • For search relevance evaluation methodology, see references/relevance-evaluation.md

© asgard-ai-platform, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in algo-ecom-search of asgard-ai-platform/skills.

  • SKILL.md
  • examples/sample_scenario.md
  • references/query-pipeline.md
  • references/relevance-evaluation.md

Open the folder on GitHubat commit 4e7f4f8

Compare with similar skills

Algo Ecom Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Algo Ecom Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Algo Ecom Search this skillasgard-ai-platform/skills242—~1.2kAutomated safety check: PassMIT
Amazon Buy Box Monitorbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Tourmind Bookingtourmind-com/Tourmind-Booking-Skills1.8k—~13kAutomated safety check: PassMIT
Ecommerce Image Suitewzj177/ecommerce-image-suite449—~10kAutomated safety check: PassApache-2.0
Zach Feature Demand Validatorzach22-1999/amazon-skills2091 repos~2.3kAutomated safety check: NotesMIT
Caramel CouponsDevinoSolutions/caramel141—~1.1kAutomated safety check: PassAGPL-3.0

Similar skills

  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Sales & SupportAuto-check passed
  • Tourmind Booking

    tourmind-com/Tourmind-Booking-Skills

    MUST USE for any hotel or accommodation intent in any language, including hotel search, hotel recommendations, nearby accommodation, hostels, guesthouses, resorts, where-to-stay questions, room…

    1.8k GitHub stars~13k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Ecommerce Image Suite

    wzj177/ecommerce-image-suite

    电商套图生成助手。用户明确提出需要生成电商套图、商品主图、卖点图、场景图、模特图等图片内容时触发. An agent skill from wzj177/ecommerce-image-suite.

    449 GitHub stars~10k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Zach Feature Demand Validator

    zach22-1999/amazon-skills

    功能需求真伪验证器。用三维数据(Review/关键词/社区)验证微创新是否真实需求. An agent skill from zach22-1999/amazon-skills.

    209 GitHub starsUsed in 1 repo~2.3k tokens
    Sales & SupportAuto-check: notes
  • Caramel Coupons

    DevinoSolutions/caramel

    Look up live coupon / promo codes for any online store through Caramel's public API (grabcaramel.com) — use whenever the user is about to buy something online, asks for a discount or promo code, or…

    141 GitHub stars~1.1k tokensUpdated today
    Sales & SupportAuto-check passed
  • Zach Sif Cvr Threshold Analyzer

    zach22-1999/amazon-skills

    基于领星 ASIN 360 或同类日业务报表,以及用户自己 SIF MCP 导出的日级关键词自然排名 JSON,回测 CVR 与核心词/稳定词自然排名波动的关系,并输出观察线、危险线、广告 CVR 确认线。

    209 GitHub starsUsed in 1 repo~982 tokens
    Sales & SupportAuto-check: notes

More from asgard-ai-platform/skills

All 207 skills in this repo
  • Algo Ecom Bm25

    asgard-ai-platform/skills

    Implement BM25 ranking function for e-commerce product search relevance scoring.

    242 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Mfg Cpk

    asgard-ai-platform/skills

    Calculate Cpk process capability index to assess whether a process meets specification requirements.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Price Elasticity

    asgard-ai-platform/skills

    Calculate price elasticity of demand to quantify how price changes affect sales volume.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Bayesian

    asgard-ai-platform/skills

    Apply Bayesian averaging to rank items by combining observed ratings with prior expectations.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Elo

    asgard-ai-platform/skills

    Implement Elo rating system to rank items or players from pairwise comparison outcomes.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Wilson

    asgard-ai-platform/skills

    Calculate Wilson Score confidence intervals for ranking items by positive proportion with sample size correction.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Algo Ecom Search

What does Algo Ecom Search do?

Optimize e-commerce search relevance across the full pipeline from query understanding to result presentation. Algo Ecom Search is an agent skill from asgard-ai-platform/skills. Optimize e-commerce search relevance across the full pipeline from query understanding to result presentation.

When should I use Algo Ecom Search?

Algo Ecom Search fits situations like: the user needs to improve search quality; implement query processing features; diagnose search relevance issues — even if they say search results are bad; improve product search.

How do I install Algo Ecom Search in Claude Code?

Run `npx skills add asgard-ai-platform/skills --skill algo-ecom-search -a claude-code`. Or copy the skill folder (algo-ecom-search in asgard-ai-platform/skills) into .claude/skills/algo-ecom-search in your project. Claude Code loads it when a task matches its description.

How do I install Algo Ecom Search in Codex?

Run `npx skills add asgard-ai-platform/skills --skill algo-ecom-search -a codex`. Or copy the skill folder (algo-ecom-search in asgard-ai-platform/skills) into .agents/skills/algo-ecom-search in your project. Codex loads it when a task matches its description.

Can I use Algo Ecom Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add asgard-ai-platform/skills --skill algo-ecom-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/algo-ecom-search, .gemini/skills/algo-ecom-search, .github/skills/algo-ecom-search and .opencode/skills/algo-ecom-search in your project.

What does Algo Ecom Search need to run?

SKILL.md names no scripts, command-line tools or credentials: Algo Ecom Search is instructions for the agent only.

Does Algo Ecom Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Algo Ecom Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Algo Ecom Search use?

Algo Ecom Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Algo Ecom Search use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.7k tokens, read only when the agent opens those files.

What are the alternatives to Algo Ecom Search?

Skills that share tags, products or a category with Algo Ecom Search: Amazon Buy Box Monitor (browser-act/skills, 6.1k stars), Tourmind Booking (tourmind-com/Tourmind-Booking-Skills, 1.8k stars), Ecommerce Image Suite (wzj177/ecommerce-image-suite, 449 stars) and Zach Feature Demand Validator (zach22-1999/amazon-skills, 209 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Algo Ecom Search?

asgard-ai-platform (a GitHub organization) maintains it in asgard-ai-platform/skills, which has 242 GitHub stars. The repository holds 207 skills in this directory. The repository was last updated on June 6, 2026.

Source: asgard-ai-platform/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.