Skip to content

feat(mcp): add RediSearch skill prompts#843

Merged
joshrotenberg merged 1 commit intomainfrom
feat/search-skills
Mar 7, 2026
Merged

feat(mcp): add RediSearch skill prompts#843
joshrotenberg merged 1 commit intomainfrom
feat/search-skills

Conversation

@joshrotenberg
Copy link
Collaborator

Summary

  • Add three SKILL.md files under crates/redisctl-mcp/skills/ for RediSearch optimization workflows
  • index-advisor: analyzes dataset shape (types, cardinality, value distributions) and recommends optimal FT.CREATE schema with aliases, weights, and SORTABLE flags
  • query-tuning: uses FT.EXPLAIN and FT.PROFILE to analyze query execution plans, identify bottlenecks, and suggest optimizations with before/after comparisons
  • index-ab-test: creates multiple index variants, benchmarks them with representative queries, and produces a comparison matrix to find the best configuration

These follow the Agent Skills format (YAML frontmatter + markdown body) and will be registered as MCP prompts via DynamicPromptRegistry once tower-mcp 0.8.2+ is integrated.

Tested

Both index-advisor and query-tuning were tested end-to-end against a live Redis Stack instance with 8 JSON product documents:

  • Index advisor correctly inferred field types, analyzed cardinality, recommended TAG vs TEXT, and produced a working FT.CREATE with aliases
  • Query tuning correctly used FT.EXPLAIN/FT.PROFILE to compare global vs field-specific queries with a metrics comparison table

Test plan

  • Skills follow Agent Skills SKILL.md format
  • index-advisor tested end-to-end against live data
  • query-tuning tested end-to-end against live data
  • index-ab-test to be validated when integrated with dynamic prompts

Ref #838

Add three SKILL.md files following the Agent Skills format for use as
MCP prompts once dynamic prompt registration lands in tower-mcp:

- index-advisor: analyze dataset shape and recommend optimal FT.CREATE schema
- query-tuning: optimize queries using FT.EXPLAIN and FT.PROFILE
- index-ab-test: create and benchmark multiple index configurations

Each skill encodes domain expertise as structured steps and heuristics
that guide the LLM through multi-tool workflows using the existing
124 database tools.

Ref #838
@joshrotenberg joshrotenberg merged commit 0e4183f into main Mar 7, 2026
12 checks passed
@joshrotenberg joshrotenberg deleted the feat/search-skills branch March 7, 2026 03:56
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.

1 participant