Skip to content

feat: add algolia-implementation planning suite (11 skills) - #33

Merged
itsdanwilli merged 2 commits into
mainfrom
feat/algolia-implementation-skills
Jul 28, 2026
Merged

feat: add algolia-implementation planning suite (11 skills)#33
itsdanwilli merged 2 commits into
mainfrom
feat/algolia-implementation-skills

Conversation

@itsdanwilli

@itsdanwilli itsdanwilli commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

feat: add algolia-implementation planning suite (11 skills)

What

Adds an implementation-planning suite that complements the existing operational skills. Where algolia-cli, algolia-mcp, algobot-cli, and instantsearch execute operations and write code, this suite plans, sequences, and validates the work: discovery questions, data/event contracts, relevance decisions, UI readiness, AI-feature rollout, and release QA.

Skills added (installed as one algolia-implementation plugin):

Skill Role
algolia-discovery-planning Entry point — maps any request to lifecycle phases, loads companions
algolia-search-implementation Execution checklist for net-new builds
algolia-data-modeling Record shape, variants, objectID, facets, event attribution
algolia-index-configuration Relevance settings, synonyms, rules, replicas, rollback
algolia-ui-libraries Living selector for current UI libraries
algolia-instantsearch-ui Readiness layer for results/browse experiences
algolia-autocomplete Source strategy and selection contracts for typeahead
algolia-events-insights Event taxonomy, queryID/userToken guidance
algolia-neuralsearch NeuralSearch readiness, rollout, measurement
algolia-agent-studio Agent Studio planning, guardrails, launch gates
algolia-release-qa Severity-led launch QA

No overlap with existing skills — by design

Every skill carries explicit Do NOT use boundaries routing to the existing skills: live account operations → algolia-cli / algolia-mcp; Agent Studio config/deploy → algobot-cli; framework APIs and code-level UI work → instantsearch. The suite is the customer-readiness layer around them, not a replacement. algolia-discovery-planning is the single trigger entry point; companions carry precise disambiguation to avoid collisions.

Quality

  • All factual claims audited against current public docs (July 2026): Insights event names and semantics, index settings, NeuralSearch activation behavior, Agent Studio terminology, Angular InstantSearch deprecation.
  • Each skill ships SKILL.md (<160 lines), references/, agents/openai.yaml, and evals/evals.json (32 evals total).
  • scripts/validate_skills.py: 122 checks, 0 failures.
  • MIT-licensed, no customer data or credentials.

Provenance

Developed in itsdanwilli/algolia-implementation-skills with SME review. Contact: daniel.williams@algolia.com.

itsdanwilli and others added 2 commits July 22, 2026 23:12
Adds a companion bundle that plans, sequences, and validates Algolia
implementations end to end, complementing the operational skills:

- algolia-discovery-planning (entry point / phase orchestrator)
- algolia-search-implementation (net-new build checklist)
- algolia-data-modeling, algolia-index-configuration
- algolia-ui-libraries, algolia-instantsearch-ui, algolia-autocomplete
- algolia-events-insights, algolia-neuralsearch, algolia-agent-studio
- algolia-release-qa

Each skill ships SKILL.md, references/, agents/openai.yaml, and
evals/evals.json. The suite routes live account operations to
algolia-cli / algolia-mcp / algobot-cli and code-level UI work to
instantsearch, with explicit Do-NOT-use boundaries to avoid trigger
collisions. Registered as a single 'algolia-implementation' plugin in
marketplace.json; validate_skills.py passes (122 checks).
Rename the rollout-recommendation vocabulary (limited pilot -> limited
rollout) in SKILL.md, references, and evals; matches the source repo.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@leonardocuco
leonardocuco self-requested a review July 24, 2026 13:51
@leonardocuco

Copy link
Copy Markdown
Collaborator

@itsdanwilli are you ready to merge or are you still working on this? :)

@itsdanwilli
itsdanwilli merged commit dc12547 into main Jul 28, 2026
1 check passed
@itsdanwilli
itsdanwilli deleted the feat/algolia-implementation-skills branch July 28, 2026 15:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants