skills.rest
zivtech
zivtechOFFICIAL
Explore all skills by this author →
WebsiteGitHub

search-discovery-critic

Audit search index design, facets, and relevance tuning for Solr, Elasticsearch, Algolia, and Drupal Search API.

Updated Mar 5, 2026
Search Tags:#architecture#audit#search#discovery#relevance#ux
One-click install
npx skills add https://github.com/zivtech/joyus-desktop --skill search-discovery-critic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: search-discovery-critic
Source: https://github.com/zivtech/joyus-desktop/tree/main/.claude/skills/search-discovery-critic
Command: npx skills add https://github.com/zivtech/joyus-desktop --skill search-discovery-critic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the gap between technically functional search systems and those that actually help users find what they need, preventing launch failures and user abandonment.

Core Features & Use Cases

  • Holistic Architecture Audit: Evaluates index design, facet strategy, relevance tuning, and zero-result handling.
  • Root-Cause Diagnosis: Traces poor search analytics (high bounce, low click-through) back to specific configuration layers.
  • Use Case: Use this skill before a major site launch to verify that your Elasticsearch or Algolia configuration will handle real-world user queries and content structures effectively.

Quick Start

Use the search-discovery-critic skill to perform a comprehensive audit of the current search configuration files and analytics data.

Frequently Asked Questions about search-discovery-critic

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit Elasticsearch index design for search findability issues?▼

Diagnosing poor search analytics like high bounce rates requires tracing symptoms back to specific search configuration layers, evaluating index design, facet strategy, relevance tuning, and zero-result handling to identify root causes.

Why does my Algolia search return irrelevant results and high bounce rates?▼

Poor search relevance and high bounce rates often stem from suboptimal facet configuration or relevance tuning in your search architecture, requiring a diagnostic audit of index mappings and user-facing analytics to resolve.

Can I use this search architecture audit for Drupal Search API configurations?▼

Yes, you can audit Drupal Search API configurations, as the evaluation applies to search-enabled platforms including Solr, Elasticsearch, and Algolia, identifying findability failures by analyzing index design and facet strategy.

What data is needed to perform a search relevance and discovery audit?▼

Performing a search relevance audit requires access to search configuration files, index mappings, and user-facing search analytics to provide evidence-based architectural recommendations for resolving findability failures.

When should I review search facets and zero-result handling before a site launch?▼

Review search facets and zero-result handling before a major site launch to verify that your search configuration will handle real-world user queries and content structures effectively, preventing user abandonment.

Related Skills

Explore More Software Engineering Skills→
musher-devmusher-dev

designing-search-discovery

Design and audit documentation search systems with federated search and CMD+K patterns.

Official
Advanced
zivtechzivtech

search-discovery-planner

Design search and discovery architectures by mapping content models to index configurations.

Official
Advanced
ArdurAIArdurAI
1

god-search-engineering

Engineer search systems across Elasticsearch, OpenSearch, Typesense, and Apache Solr.

Official
Advanced
Impertio-StudioImpertio-Studio

postgres-syntax-full-text-search

Optimize PostgreSQL text search queries using tsvector and tsquery with ranking and indexing strategies.

Official
Advanced