faceted-navigation

faceted-navigation is a skill for Claude Code, Codex from finsilabs/awesome-ecommerce-skills. It costs 26 tokens per session (2,549 once invoked), scanned A, original, MIT.

A product-listing filter system that lets shoppers narrow results by several attributes at once, such as size, color, brand, price, or rating. The current filters stay in the URL so they can be shared, bookmarked, or crawled by search engines.

In plain words
What is it for?
Use it to build category and collection filters, support mobile filter controls, and connect filtering to Algolia or Elasticsearch.
Why use it?
It helps shoppers handle large catalogs without scrolling through unrelated products. Keeping filters in the URL also preserves back-button behavior and makes filtered pages easier to share.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: positional $N argument; mentions Codex; mentions Gemini CLI.

Good fit Use it to build category and collection filters, support mobile filter controls, and connect filtering to Algolia or Elasticsearch.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/finsilabs/awesome-ecommerce-skills/faceted-navigation
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add finsilabs/awesome-ecommerce-skills --skill faceted-navigation
Clone the repo
git clone --depth 1 https://github.com/finsilabs/awesome-ecommerce-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for faceted-navigation

README.md
[![agentmods](https://agentmods.dev/badge/skills/finsilabs/awesome-ecommerce-skills/faceted-navigation/github.svg)](https://agentmods.dev/skills/finsilabs/awesome-ecommerce-skills/faceted-navigation)
Your own site
<a href="https://agentmods.dev/skills/finsilabs/awesome-ecommerce-skills/faceted-navigation"><img src="https://agentmods.dev/badge/skills/finsilabs/awesome-ecommerce-skills/faceted-navigation/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for faceted-navigation

Your own site · 80×15
<a href="https://agentmods.dev/skills/finsilabs/awesome-ecommerce-skills/faceted-navigation"><img src="https://agentmods.dev/badge/skills/finsilabs/awesome-ecommerce-skills/faceted-navigation.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 26 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,549 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00026 $0.02549
Opus 5 $0.00013 $0.01274
Sonnet 5 $0.00005 $0.00510
Haiku 4.5 $0.00003 $0.00255

Measured 9d ago against content hash 5087ed72ce0c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

faceted-navigation scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/storefront-ui/faceted-navigation/SKILL.md · 207 lines

How it starts

The opening of the file, as written. The whole thing — 207 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Faceted Navigation

Overview

Build a filterable product listing page (PLP) where shoppers can narrow results by multiple attributes simultaneously — size, color, brand, price range, rating — while keeping the URL in sync so filters are shareable, bookmarkable, and crawlable by search engines. Good faceted navigation drives measurable conversion lift on catalogs with more than 50 SKUs.

When to Use This Skill

  • When a product catalog exceeds ~50 SKUs and browse-only navigation causes shopper frustration
  • When building or redesigning a category/collection listing page
  • When SEO requires crawlable faceted URLs (e.g., /shoes/running?color=black&size=10)
  • When replacing a legacy faceted implementation that breaks the back button
  • When implementing Algolia InstantSearch or a custom faceting layer on Elasticsearch

Core Instructions

Step 1: Determine the merchant's platform and choose the right approach

Platform Recommended Approach Why
Shopify Enable native collection filters (Online Store 2.0 themes) + install Search & Discovery app (free) Dawn, Sense, and other OS2.0 themes support native storefront filtering via the Storefront API; Search & Discovery adds synonym, boosting, and filter configuration from the admin
WooCommerce Install FiboSearch (paid, $49/yr) or WooCommerce Product Filters (free) plugin FiboSearch adds AJAX-powered facets with price slider, color swatches, and stock filter; the free Product Filters plugin covers basic attribute filtering with URL state
BigCommerce Enable Faceted Search in Storefront → Search settings (built-in on Cornerstone and most themes) BigCommerce Faceted Search is native to the platform — configure which product attributes appear as facets in the admin; no app required
Custom / Headless Build with Algolia InstantSearch or Elasticsearch + URL state management Full control over facet logic, disjunctive filtering, and count freshness; see implementation details below

Read the full file on GitHub · 207 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 207 lines · 26 tokens per session scan A 5087ed72ce0c

Subscribe to this mod's changes

faceted-navigation is a skill published in the GitHub repository finsilabs/awesome-ecommerce-skills (52 stars, last pushed 6mo ago), licensed MIT. It adds 26 tokens to every session and 2,549 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

algolia-search-implementation

Execution checklist for net-new Algolia search, browse, autocomplete, ecommerce search, recommendations, personalization, Dynamic Re-Ranking, or search UI builds. Use during a greenfield build to keep data contract, event taxonomy, index configuration, UI, and release QA visible as explicit checkpoints with completion…

algolia/skills · 119 tokens

shopify-expert

Builds and debugs Shopify themes (.liquid files, theme.json, sections), develops custom Shopify apps (shopify.app.toml, OAuth, webhooks), and implements Storefront API integrations for headless storefronts. Use when building or customizing Shopify themes, creating Hydrogen or custom React storefronts, developing…

Jeffallan/claude-skills · 117 tokens

site-config-creation

Create or update the [site] section of stencila.toml for published Stencila sites. Use when asked to configure site domain, title, author, logo, icons, labels, descriptions, socials, featured content, navigation, routes, access, layout presets and regions, glide, search, formats, reviews, uploads, remotes, actions…

stencila/stencila · 106 tokens

menu-interactions

Wire mouse, wheel and touch input for react-horizontal-scrolling-menu: onWheel/onScroll are plain (api, event) => void callbacks, while ALL mouse/touch props (onMouseDown, onMouseUp, onMouseMove, onMouseLeave, onTouchStart, onTouchMove, onTouchEnd) are handler factories (api) => (event) => void. Covers mouse…

asmyshlyaev177/react-horizontal-scrolling-menu · 147 tokens

menu-migration

Detect and upgrade pre-v8 react-horizontal-scrolling-menu patterns that agents trained on older data still generate: destructured visibleElements/isFirstItemVisible/isLastItemVisible/initComplete (removed v6), Separator items, separatorClassName and getPrevItem/getNextItem (removed v7), the Arrows prop (removed v3)…

asmyshlyaev177/react-horizontal-scrolling-menu · 160 tokens

menu-recipes

Recipes composed on the react-horizontal-scrolling-menu public API — NOT props: autoplay (setInterval + scrollNext gated on menuVisible), infinite loop/carousel (clone head/tail + scrollLeft teleport at seams), center on click (scrollToItem 'center'), save/restore scroll position (onUpdate, onInit, scrollContainer)…

asmyshlyaev177/react-horizontal-scrolling-menu · 145 tokens