Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Algolia Search Integration · davila7 | DecimalAI

davila7/algolia-search

SkillScore91Maintained

Expert patterns for Algolia search implementation, indexing strategies, React InstantSearch, and relevance tuning Use when: adding search to, algolia, instantsearch, search api, search functionality.

Frontendby davila7

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Frontend / UI pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/davila7-algolia-search/SKILL.md

decimalai skills pull davila7-algolia-search --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/davila7-algolia-search/SKILL.md https://app.decimal.ai/s/davila7-algolia-search/SKILL.md

Raw file: /s/davila7-algolia-search/SKILL.md ↗ · machine-readable summary at /s/davila7-algolia-search.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

23 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 47d ago

Yes — +13% lift-15% tokens0% turns91% of whole cases pass with skill (21/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-08	✗→✓	▲ Improved	-30%	0%
case-19	✗→✓	▲ Improved	-43%	0%
case-23	✗→✓	▲ Improved	-15%	0%
case-06	✓→✓	＝ Same ✓	-24%	0%
case-02	✓→✓	＝ Same ✓	-13%	0%

Showing 5 of 23 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

davila7 / claude-code-templates

cli-tool/components/skills/development/algolia-search/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

Skill contents

SKILL.md

Algolia Search Integration

Patterns

React InstantSearch with Hooks

Modern React InstantSearch setup using hooks for type-ahead search.

Uses react-instantsearch-hooks-web package with algoliasearch client. Widgets are components that can be customized with classnames.

Key hooks:

useSearchBox: Search input handling
useHits: Access search results
useRefinementList: Facet filtering
usePagination: Result pagination
useInstantSearch: Full state access

Next.js Server-Side Rendering

SSR integration for Next.js with react-instantsearch-nextjs package.

Use <InstantSearchNext> instead of <InstantSearch> for SSR. Supports both Pages Router and App Router (experimental).

Key considerations:

Set dynamic = 'force-dynamic' for fresh results
Handle URL synchronization with routing prop
Use getServerState for initial state

Data Synchronization and Indexing

Indexing strategies for keeping Algolia in sync with your data.

Three main approaches:

Full Reindexing - Replace entire index (expensive)
Full Record Updates - Replace individual records
Partial Updates - Update specific attributes only

Best practices:

Batch records (ideal: 10MB, 1K-10K records per batch)
Use incremental updates when possible
partialUpdateObjects for attribute-only changes
Avoid deleteBy (computationally expensive)

⚠️ Sharp Edges

| Issue | Severity | Solution | |-------|----------|----------| | Issue | critical | See docs | | Issue | high | See docs | | Issue | medium | See docs | | Issue | medium | See docs | | Issue | medium | See docs | | Issue | medium | See docs | | Issue | medium | See docs | | Issue | medium | See docs |

Illustrative Want to see what davila7/algolia-search would put in front of your model? Preview the rendered body and check its trigger phrases — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/11/2026, 22:34 UTC · 23 cases

Lift

+13%

91% vs 78%

Agent turns

1.0 vs 1.0

Tokens

-15%

1,404.57 vs 1,656.91

fail → pass · 3pass → pass · 18fail → fail · 2

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I need to build a custom search interface in a React application with type-ahead search, faceted category filters, and pagination controls. Can you provide an overview of the modern hook-based frontend architecture for Algolia search and how each primary hook should be utilized?	fail→fail	16,144	15,262	-5%	1	1	0%	3,336	3,558	+7%	0	0	—
case-06 In Next.js Pages Router, which utility function is executed on the server side to fetch initial search engine state prior to client rendering?	pass→pass	8,704	4,052	-53%	1	1	0%	1,529	1,164	-24%	0	0	—
case-02 We are migrating our Next.js e-commerce search page to server-side rendering so search engine crawlers can index rendered search results. Which top-level component wrapper should replace the standard client-side InstantSearch component?	pass→pass	5,715	2,940	-49%	1	1	0%	1,085	940	-13%	0	0	—
case-03 Which specific NPM library provides official Next.js server-side rendering support and SSR wrapper components for Algolia search?	pass→pass	6,395	1,767	-72%	1	1	0%	1,270	694	-45%	0	0	—
case-04 On our Next.js App Router search page, initial search queries evaluated on the server are returning stale static build outputs across user sessions. What App Router dynamic route configuration export should be set on the search page file?	pass→pass	6,309	3,024	-52%	1	1	0%	1,178	901	-24%	0	0	—
case-05 We need the browser URL address bar in our Next.js search application to stay in sync with search input queries, selected category refinements, and pagination changes. Which property on the InstantSearch wrapper handles URL synchronization?	pass→pass	3,591	3,624	+1%	1	1	0%	635	1,069	+68%	0	0	—
case-07 We are building a custom React search UI from scratch and want to use dedicated React hooks rather than pre-built UI widget containers. Which official NPM package should we install for web React search hooks?	fail→fail	7,850	5,874	-25%	1	1	0%	1,515	1,513	-0%	0	0	—
case-08 We need to create a custom search text input component in React. Which hook handles managing the search query string and sending query updates to the search engine?	fail→pass	7,820	3,197	-59%	1	1	0%	1,493	1,050	-30%	0	0	—
case-09 We are building a custom product card grid in React to render search results. Which hook provides direct access to the search result records?	pass→pass	4,569	2,388	-48%	1	1	0%	797	880	+10%	0	0	—
case-10 We want to render a custom sidebar of category filter checkboxes in our React search UI. Which hook provides facet refinement items and toggle handlers?	pass→pass	6,286	4,201	-33%	1	1	0%	1,066	1,146	+8%	0	0	—
case-11 We need to build custom page navigation buttons (previous, next, page numbers) in our React search interface. Which hook supplies pagination controls?	pass→pass	8,114	3,584	-56%	1	1	0%	1,494	1,063	-29%	0	0	—
case-12 When building a global search status bar in React that needs full access to current query status, index context, and engine lifecycle events, which hook should be used?	pass→pass	8,799	4,564	-48%	1	1	0%	1,747	1,198	-31%	0	0	—
case-13 Our backend catalog worker needs to update product prices and inventory counts for 10,000 existing records in Algolia without touching or re-uploading other fields like product descriptions or image URLs. Which API method should be called?	pass→pass	5,753	6,798	+18%	1	1	0%	1,042	1,704	+64%	0	0	—
case-14 When running backend batch updates to push product catalog records to an Algolia index, what is the ideal record count range per batch request?	pass→pass	19,523	3,025	-85%	1	1	0%	1,886	909	-52%	0	0	—
case-15 Our backend indexing job groups product payload data into network requests. What is the recommended target payload size limit in megabytes per batch request?	pass→pass	10,685	1,543	-86%	1	1	0%	1,827	649	-64%	0	0	—
case-16 Our database cleanup script needs to purge expired records from an index. A developer proposed using the deleteBy API method. Why is deleteBy discouraged for routine bulk record updates?	pass→pass	13,479	8,952	-34%	1	1	0%	2,195	1,873	-15%	0	0	—
case-17 Our e-commerce backend updates 50 product items every hour out of a total index of 500,000 products. An engineer suggested re-uploading the entire index on every hourly update cycle. What updating strategy should be used instead?	pass→pass	10,913	8,532	-22%	1	1	0%	2,030	1,897	-7%	0	0	—
case-18 Why is performing a full index replacement considered a poor default strategy for routine inventory updates in large Algolia search indices?	pass→pass	12,130	8,186	-33%	1	1	0%	2,053	1,715	-16%	0	0	—
case-19 Is Next.js App Router support in the react-instantsearch-nextjs library documented as a fully stable production feature or as experimental?	fail→pass	6,803	1,555	-77%	1	1	0%	1,128	644	-43%	0	0	—
case-20 When using built-in React InstantSearch widgets, what is the primary recommended approach for applying custom CSS styling to widget elements?	pass→pass	8,488	4,110	-52%	1	1	0%	1,496	1,197	-20%	0	0	—
case-21 How do you configure the Algolia Insights JavaScript client to track click and conversion events when a user selects a search result?	pass→pass	13,858	11,583	-16%	1	1	0%	2,684	2,523	-6%	0	0	—
case-22 How do you configure custom ranking rules on an Algolia index to order search results by a sales_count attribute in descending order?	pass→pass	8,548	6,085	-29%	1	1	0%	1,633	1,464	-10%	0	0	—
case-23 How do you generate a restricted, time-limited secured API key on the backend to enforce multi-tenant filter restrictions on client queries?	fail→pass	14,712	10,829	-26%	1	1	0%	2,990	2,554	-15%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted. The headline lift of +13 percentage points is the difference between those two pass rates over the 23 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 78.3%
Pass rate with the skill: 91.3%
Cases attempted: 23
Cases counted toward lift: 23
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/11/2026, 22:34 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-08

Prompt

We need to create a custom search text input component in React. Which hook handles managing the search query string and sending query updates to the search engine?

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run91

Live evalNeeds ≥10 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns-17% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 47 days ago

Other measured skills in the registry, with their headline benchmark lift.