algolia-search

Expert patterns for Algolia search implementation, indexing strategies, React InstantSearch, and relevance tuning

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/algolia-search/SKILL.md

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with comprehensive executable code, but the monolithic structure and absence of inline validation checkpoints on batch/destructive indexing operations cap workflow clarity and progressive disclosure at 3. Splitting large code into bundled reference files and adding validation steps would raise the score.

Suggestions

Add explicit validation/feedback checkpoints to indexing workflows (e.g., waitTask after saveObjects, verify temp index count before atomic moveIndex swap) to lift workflow clarity above the batch/destructive cap of 3.

Move the large faceted-search and autocomplete component examples into separate bundled reference files (e.g., references/facets.md, references/autocomplete.md) and keep SKILL.md as a concise overview with one-level-deep links.

Dedupe the repeated searchClient initialization and trim full React components to the minimal illustrative snippet to improve conciseness.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with lean anti-pattern/reference subsections, but the ~900-line body repeats searchClient boilerplate across sections and inlines full React components that could be trimmed; some basic explanations (key types) pad the text.	3 / 5
Actionability	Provides fully executable, copy-paste-ready TypeScript/React code across search, SSR, indexing, security, ranking, facets, and autocomplete, covering the common cases comprehensively.	5 / 5
Workflow Clarity	Organized as a pattern catalog rather than a sequenced workflow, and batch/destructive operations (indexing, deleteObjects, moveIndex atomic swap) lack inline validation checkpoints; the rubric caps batch/destructive workflows without validation at 3.	3 / 5
Progressive Disclosure	Well-organized sections with consistent per-pattern subsections and clearly signaled doc URLs, but with no bundle files everything is inlined into a single ~900-line monolith whose component code clearly belongs in separate reference files.	3 / 5
	Total	14 / 20 Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly identifies a distinct Algolia niche with good keyword coverage, but lacks an explicit 'when to use' trigger clause, capping completeness at 3. Adding a Use-when clause and more synonyms (autocomplete, faceted search) would raise it.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when adding Algolia search, InstantSearch, autocomplete, or faceted search') to satisfy the completeness 'when' requirement.

Expand trigger terms to include natural synonyms users say: autocomplete, typeahead, faceted search, query suggestions.

Reframe topic areas as concrete verbs ('implement, index, tune, secure') to push specificity toward 5.

Dimension	Reasoning	Score
Specificity	Names the Algolia domain and several concrete capabilities ('search implementation, indexing strategies, React InstantSearch, and relevance tuning'), with only minor gaps in coverage; not quite the comprehensive list of concrete verbs that would warrant a 5.	4 / 5
Completeness	Has a clear 'what' but no 'Use when...' clause or equivalent explicit trigger guidance in the description, which per the rubric caps completeness at 3.	3 / 5
Trigger Term Quality	Strong natural keywords ('Algolia', 'search', 'React InstantSearch', 'relevance tuning') that users would say, but missing common variations present in the body such as autocomplete, typeahead, and faceted search.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Algolia-specific integration) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	16 / 20 Passed

Validation

81%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (925 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	13 / 16 Passed

Repository: sickn33/antigravity-awesome-skills
Path: skills/algolia-search/SKILL.md
Commit: 1f67c44

Reviewed: about 16 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.