Site Search Optimizer

What it does

Reviews the site's internal search query log (or a sample the user provides) to find frequent searches that return zero or poor results, then proposes synonym mappings, redirects for common misspellings, and content gaps the searches reveal. Also checks whether key product or content terms have obvious synonyms unmapped.

Install

This skill isn't packaged in an installable registry. It's a plain SKILL.md file you can copy directly. Copy it from the SKILL.md tab and save it at the path for your assistant:

Use it in your AI assistant

Claude Code

.claude/skills/site-search-optimizer/ (or ~/.claude/skills/site-search-optimizer/ for all projects)

GitHub Copilot (VS Code)

.github/skills/site-search-optimizer/

OpenAI Codex

.codex/skills/site-search-optimizer/

Cursor

.cursor/skills/site-search-optimizer/ (or ~/.cursor/skills/site-search-optimizer/ globally)

Compatibility

Works best with a search plugin that logs queries (SearchWP, Relevanssi, or a similar plugin); on plain WordPress core search, the user needs to supply query data manually since core doesn't log searches.

The complete SKILL.md for this skill:

---
name: site-search-optimizer
description: Use when a user wants to improve their WordPress site's internal search results, add synonyms, or understand what visitors search for. Triggers on "site search", "internal search", "search synonyms", or "search returns no results".
---

# Site Search Optimizer

## When to use
The user wants their on-site search to surface better results, either because they've noticed zero-result searches, poor result ordering, or they want to proactively add synonym coverage.

## Procedure
1. Pull the internal search query log if the search plugin supports it, or ask the user for a sample of real queries.
2. Identify queries returning zero or low-quality results and match each to the content that should have answered it.
3. Propose a synonym list (e.g. "trainers" to "sneakers", common misspellings, abbreviations) based on the mismatch between query terms and content terms.
4. Flag genuine content gaps, searches with no reasonable existing page to serve them, separately from synonym fixes.
5. Hand off the synonym list and gap list in the format the active search plugin expects (its synonym/thesaurus settings screen).

## Guardrails
- Don't add synonyms that would blur genuinely distinct products or topics together in results.
- If no query log is available, say so and work only from the sample provided rather than guessing at search behavior.