algolia-deploy-integration

v2026.09.24

Plan and verify deployment of an Algolia-backed application with separated browser and server credentials. Use when releasing search code, index configuration, or event instrumentation. Trigger with "deploy Algolia", "Algolia production rollout", or "search release checklist".

GitHub
Install command
npx skhub add jeremylongshore/algolia-deploy-integration
Markdown
SKILL.md

Algolia Deployment Integration

Overview

This skill coordinates application deployment with the Algolia assets it depends on. It treats code, records, settings, keys, and events as separate release surfaces with explicit ordering and rollback.

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

  • The browser receives only a search-only or secured key; write-capable keys stay in trusted server or job environments.
  • Pin application and index names per environment rather than deriving production targets from branch names.
  • Complete indexing tasks and representative queries before routing production traffic.
  • Deploy event instrumentation only after user-token, consent, query ID, and validation behavior are reviewed.

Authentication

Provision custom least-privilege keys through the approved secret store. Never place Admin keys in static build variables, client bundles, deployment logs, or preview environments.

Instructions

  1. Map the deploy platform, runtime boundaries, environment variables, index targets, and current rollback mechanism.
  2. Verify client packages and API usage against the pinned lockfile and current first-party docs.
  3. Prepare or verify target records, settings, synonyms, and rules before the application cutover.
  4. Deploy server and browser configuration with credential separation and redacted logging.
  5. Run a read-only health check plus representative search tests against the intended target.
  6. Record release SHA, index state, task receipts, smoke results, and rollback trigger.

Approval Boundaries

Do not overwrite production indices, rotate keys, promote settings, or enable events as an implicit side effect of application deployment.

Output

Return the release topology, environment map, credential classification, ordered deployment plan, smoke evidence, rollback steps, and unresolved approvals.

Error Handling

ConditionResponse
Browser bundle contains write keyStop deployment and rotate the exposed credential.
Target index is staleHold traffic and complete or rollback indexing.
Health check passes but relevance failsUse representative query gates, not connectivity alone.
Rollback target unknownDo not cut over.

Examples

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

Input:

release=abc123; environment=production; browser-key=search-only; server-key=custom-write

Expected handoff:

index-task=complete; smoke=pass; representative-queries=pass; rollback=previous-release

Resources

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/.curated/algolia-deploy-integration

Default branch

main

Latest commit

e5a6c3b

Tree SHA

c2dc8e8