AL

algolia-search

Implements Algolia search with best practices for indexing, performance, and React integration.

Install

mkdir -p .claude/skills/algolia-search && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7915" && unzip -o skill.zip -d .claude/skills/algolia-search && rm skill.zip

Installs to .claude/skills/algolia-search

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Expert patterns for Algolia search implementation, indexing strategies, React InstantSearch, and relevance tuning Use when: adding search to, algolia, instantsearch, search api, search functionality.
199 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • Initialize React InstantSearch with hooks
  • Configure SSR using InstantSearchNext
  • Perform partial record updates
  • Manage search state through widgets
  • Implement batch record indexing

How it works

Provides code templates for hooks-based React integration and RESTful batch synchronization scripts for record maintenance.

Inputs & outputs

You give it
Index name, search attributes, and dataset
You get back
Search-ready UI components and indexing scripts

When to use algolia-search

  • Implement type-ahead search with React InstantSearch
  • Configure SSR for Algolia in Next.js
  • Optimize indexing strategies for large datasets
  • Perform partial record updates to sync data

About this skill

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:

  1. Full Reindexing - Replace entire index (expensive)
  2. Full Record Updates - Replace individual records
  3. 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

IssueSeveritySolution
IssuecriticalSee docs
IssuehighSee docs
IssuemediumSee docs
IssuemediumSee docs
IssuemediumSee docs
IssuemediumSee docs
IssuemediumSee docs
IssuemediumSee docs

When not to use it

  • Small datasets not requiring cloud search
  • Projects requiring full-text search without external APIs

Prerequisites

Algolia API keyreact-instantsearch-hooks-webreact-instantsearch-nextjs

Limitations

  • Batch indexing requires careful record size management
  • Expensive computational cost of deleteBy operations
  • SSR requires complex state synchronization handling

How it compares

Offers specific patterns for Next.js SSR and partial synchronization rather than general API implementation advice.

Compared to similar skills

algolia-search side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
algolia-search (this skill)06moNo flagsIntermediate
javascript-typescript-typescript-scaffold34moReviewBeginner
server-actions17moNo flagsIntermediate
fullstack-developer05moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

software-architecture

davila7

Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development.

333868

planning-with-files

davila7

Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requiring >5 tool calls.

233106

telegram-bot-builder

davila7

Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, user experience, monetization strategies, and scaling bots to thousands of users. Use when: telegram bot, bot api, telegram automation, chat bot telegram, tg bot.

106130

scroll-experience

davila7

Expert in building immersive scroll-driven experiences - parallax storytelling, scroll animations, interactive narratives, and cinematic web experiences. Like NY Times interactives, Apple product pages, and award-winning web experiences. Makes websites feel like experiences, not just pages. Use when: scroll animation, parallax, scroll storytelling, interactive story, cinematic website.

101142

humanizer

davila7

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. Credits: Original skill by @blader - https://github.com/blader/humanizer

90175

game-development

davila7

Game development orchestrator. Routes to platform-specific skills based on project needs.

70195

Search skills

Search the agent skills registry