# redis-search

> Claude/Codex skill by [@redis](https://omgskills.com/library/redis/index.md) · 169 stars · Updated 2026-09-08

Redis Search guidance covering FT.CREATE schema design, field type selection (TEXT, TAG, NUMERIC, GEO, GEOSHAPE, VECTOR, JSON path), DIALECT 2 query syntax, FT.SEARCH / FT.AGGREGATE / FT.HYBRID command selection, vector similarity with HNSW or FLAT, hybrid retrieval combining lexical and vector ranking, RAG pipelines, zero-downtime index updates via aliases, and debugging with FT.PROFILE and FT.EXPLAIN. Use when defining a search index on Hash or JSON documents, writing FT.SEARCH queries with filters, sorting, aggregation, or vector KNN, tuning HNSW parameters, building a RAG retrieval pipeline, or troubleshooting slow or empty search results.

Tags: agent-skills, redis

## Install

```sh
git clone https://github.com/redis/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/redis-search ~/.claude/skills/redis-search
```

## From README

Redis Search Single source of guidance for Redis Search — the retrieval surface that spans lexical, numeric, geo, JSON-path, and vector queries. Vector fields are part of the same FT.CREATE machinery as TEXT/TAG/NUMERIC fields, and FT.HYBRID blends lexical and vector ranking in one command, so this skill covers them together. When to apply Creating, modifying, or reviewing a Redis Search index (FT.CREATE, FT.ALTER). Writing or optimizing FT.SEARCH, FT.AGGREGATE, or FT.HYBRID queries. Picking between TEXT, TAG, NUMERIC, GEO, GEOSHAPE, VECTOR, or JSON-path fields. Defining a VECTOR field, choosing HNSW vs FLAT, tuning HNSW parameters. Building a retrieval-augmented generation (RAG) pipeline. Rolling out a new index schema without downtime. Troubleshooting empty results, slow queries, or tokenization issues with FT.EXPLAIN, FT.PROFILE, FT.INFO. Pick the right command Three query commands. Reach for the narrowest one that fits.

## Links

- HTML page: https://omgskills.com/library/redis/agent-skills/skills/redis-search/
- GitHub: https://github.com/redis/agent-skills
- Author: [@redis](https://omgskills.com/library/redis/index.md)

## More from this repo

- [iris-development](https://omgskills.com/library/redis/agent-skills/skills/iris-development/index.md) — Iris is Redis's umbrella for AI-focused products.
   - [@redis](https://omgskills.com/library/redis/index.md) · 169 stars
- [redis-clustering](https://omgskills.com/library/redis/agent-skills/skills/redis-clustering/index.md) — Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and...
   - [@redis](https://omgskills.com/library/redis/index.md) · 169 stars
- [redis-connections](https://omgskills.com/library/redis/agent-skills/skills/redis-connections/index.md) — Redis client and connection guidance covering connection pooling, multiplexing, pipelining, client-side caching with...
   - [@redis](https://omgskills.com/library/redis/index.md) · 169 stars