Agent-Skills.md

Agent Skills: Algolia Verified First Search

"Create a minimal working Algolia example \u2014 index records and search\

UncategorizedID: jeremylongshore/claude-code-plugins/algolia-hello-world

Repository

jeremylongshore/claude-code-plugins
jeremylongshoreLicense: MIT
2,458348

Install this agent skill to your local

pnpm dlx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/HEAD/plugins/saas-packs/algolia-pack/skills/algolia-hello-world

Skill Files

Browse the full folder contents for algolia-hello-world.

Download Skill

Loading file tree…

plugins/saas-packs/algolia-pack/skills/algolia-hello-world/SKILL.md

Skill Metadata

Name
algolia-hello-world
Description
>-

Algolia Verified First Search

Overview

This skill proves the smallest complete write-read-cleanup cycle: create known records, wait for the indexing task, query one record, and remove the disposable index after review.

Prerequisites

  • A named repository, environment, and Algolia application or index in scope
  • The local lockfile and installed client types as implementation authority
  • A safe read-only query or explicitly disposable test target
  • Current first-party documentation for any provider behavior that affects the change

Tool Discipline

Use Read, Glob, and Grep to inspect local code, configuration names, tests, and dependency versions. Use WebFetch only for current official Algolia documentation. Use Write or Edit only after identifying the target files, constraints, and verification plan.

Current Contract

  • Use the installed algoliasearch v5 client; methods such as saveObjects, waitForTask, and searchSingleIndex are called on the client.
  • Assign explicit objectID values so verification is deterministic.
  • Use a new disposable index, never an existing production index.
  • Treat cleanup as an observed task with its own result.

Authentication

Use a custom backend key restricted to the disposable index and necessary operations. The browser should never receive this write credential.

Instructions

  1. Confirm the package version, application ID, credential source, and validated disposable index name.
  2. Create two non-sensitive records with stable object IDs.
  3. Save the records and retain the returned task ID.
  4. Wait for that task, then search for one unique value with searchSingleIndex.
  5. Assert the expected object ID and record the request metadata without secrets.
  6. After human confirmation, delete the disposable index and verify cleanup.

Approval Boundaries

Do not use a production index, copy an Admin key into source, or delete an index until its exact disposable name is displayed and approved.

Output

Return package and API evidence, the redacted configuration, write and wait task IDs, search assertion, cleanup result, and next recommended integration step.

Error Handling

| Condition | Response | |---|---| | Authentication fails | Verify application/key pairing and required ACL. | | Search is empty after write | Wait for the recorded task and confirm index name. | | Unexpected existing records | Stop; the index is not disposable. | | Cleanup not approved | Leave the index and report its exact name. |

Examples

Use this compact input and expected handoff to calibrate scope and evidence quality.

Input:

app=APP…9X; index=skill-smoke-20260910; records=2

Expected handoff:

save-task=complete; expected-object=movie-1; search=pass; cleanup=approved-and-complete

Resources

Algolia Verified First Search Skill | Agent Skills