К основному содержанию
скилл CX Codex

valkey — скилл для Claude Code: настройка и установка

Скилл помогает настраивать Valkey и Redis-совместимое хранилище: от кэша и лимитов запросов до очередей и миграции с Redis. Пригодится при проектировании схемы данных и Docker Compose.

MIT 142 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill valkey -a claude-code
Открыть на GitHub

Что делает valkey

Скилл разбирает сценарии для кэша, сессий, ограничения частоты запросов, распределённых блокировок, очередей и рейтингов. Для надёжных сообщений предлагает Streams с группами потребителей, а Pub/Sub описывает как механизм без сохранения сообщений. Есть подсказки по TTL, политикам вытеснения и выбору команд.

В справочнике также разобраны Docker, сохранение данных через AOF и RDB, аутентификация и перенос с Redis. Это не замена реляционной базе: крупные значения свыше 512 MB и транзакции ACID между несколькими ключами без Lua здесь не рекомендуются. Для продакшена отсутствие maxmemory и политики вытеснения может привести к нехватке памяти.

Какие задачи решает

  • настроить кэш с TTL и политикой вытеснения
  • ограничить частоту запросов через счётчик или sorted set
  • организовать очередь с подтверждением обработки
  • выбрать между Pub/Sub и Streams для обмена сообщениями
  • перенести данные с Redis в Valkey

Примеры запросов агенту

  • Настрой кэш Valkey для этого проекта и добавь TTL к ключам.
  • Сравни варианты очереди на списках и Streams с группами потребителей.
  • Составь план миграции с Redis на Valkey с учётом RDB и AOF.

Как установить valkey

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill valkey -a claude-code

2Вручную: положить файлы

~/.claude/skills/valkey/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/valkey/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о valkey

Как установить valkey в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill valkey -a claude-code. Файл скилла появится по пути ~/.claude/skills/valkey/SKILL.md.

Что делает скилл valkey?

Он помогает выбирать команды и схемы Valkey для кэширования, сессий, очередей, блокировок и других описанных сценариев. Также содержит рекомендации по Docker, хранению данных и миграции с Redis.

Когда использовать Streams вместо Pub/Sub?

Pub/Sub не сохраняет сообщения. Для устойчивой очереди с возможностью обработки группами потребителей скилл рекомендует Streams.

Исходный текст

SKILL.md · MIT
---
name: valkey
description: 'Valkey (Redis-compatible) in-memory data store for caching, session storage, pub/sub, queues, and distributed locks. Use when configuring Valkey or Redis-compatible caching, choosing eviction policies, implementing rate limiting, setting up pub/sub or streams, writing Docker Compose services, migrating from Redis, or tuning performance. Use for valkey, redis, cache, session, pub/sub, streams, distributed-lock, rate-limit, sorted-set.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://valkey.io/commands/'
user-invocable: false
---

# Valkey

Open-source, Redis-compatible in-memory data store maintained by the Linux Foundation. Forked from Redis OSS 7.2.4 (BSD 3-Clause license). Drop-in replacement for Redis OSS 2.x through 7.2.x — same protocol, commands, and data formats.

**When to use**: Caching, session storage, rate limiting, pub/sub messaging, task queues, leaderboards, distributed locks, real-time counters, or any workload requiring sub-millisecond key-value operations.

**When NOT to use**: Primary relational data store, large object storage (>512 MB values), workloads requiring strong ACID transactions across multiple keys without Lua scripting.

## Quick Reference

| Task               | Approach                                                 | Key Point                               |
| ------------------ | -------------------------------------------------------- | --------------------------------------- |
| Cache-aside        | `GET` -> miss -> DB read -> `SET key val EX ttl`         | Always set a TTL, even a long one       |
| Session storage    | `HSET session:{id} field val` + `EXPIRE`                 | Sliding TTL on each request             |
| Rate limiting      | `INCR` + `EXPIRE` (fixed window) or sorted set (sliding) | Sorted set for precision                |
| Distributed lock   | `SET lock:{res} token NX PX 30000`                       | Always set expiry to prevent deadlocks  |
| Queue (simple)     | `LPUSH` + `BRPOP`                                        | Blocking pop with timeout               |
| Queue (reliable)   | Streams + `XGROUP` + `XACK`                              | Consumer groups for at-least-once       |
| Pub/Sub            | `SUBSCRIBE` / `PUBLISH`                                  | Fire-and-forget, no persistence         |
| Streams            | `XADD` + `XREADGROUP`                                    | Persistent, replayable, consumer groups |
| Leaderboard        | Sorted set: `ZADD` / `ZREVRANGE`                         | O(log N) rank operations                |
| Unique count       | `PFADD` + `PFCOUNT` (HyperLogLog)                        | ~12 KB memory, 0.81% error              |
| Eviction policy    | `maxmemory-policy allkeys-lru`                           | Best default for most workloads         |
| Docker setup       | `valkey/valkey:8.1-alpine`                               | Health check: `valkey-cli ping`         |
| Persistence        | AOF (`appendonly yes`) + RDB snapshots                   | AOF for durability, RDB for backups     |
| Client library     | `ioredis` or `iovalkey` (official fork)                  | All Redis clients work unchanged        |
| Migrate from Redis | Swap binary, keep data files                             | RDB/AOF compatible through Redis 7.2    |

## Common Mistakes

| Mistake                                | Correct Pattern                                  |
| -------------------------------------- | ------------------------------------------------ |
| Using `KEYS *` in production           | Use `SCAN` with cursor for iteration             |
| No TTL on cache keys                   | Always set TTL — unbounded growth causes OOM     |
| `DEL` on large keys blocking server    | Use `UNLINK` for async deletion                  |
| Pub/Sub for durable messaging          | Use Streams with consumer groups for persistence |
| Same TTL on all keys (thundering herd) | Add jitter: `EX (base + random(0, spread))`      |
| No `maxmemory` set in production       | Set `maxmemory` + eviction policy explicitly     |
| Using `MULTI/EXEC` for locking         | Use `SET ... NX PX` for distributed locks        |
| Storing large blobs (>1 MB values)     | Store references; keep values small              |
| No health check in Docker Compose      | Add `valkey-cli ping` health check               |
| Ignoring `requirepass` in production   | Always set authentication + ACLs                 |

## Delegation

- **Discover caching patterns and data model review**: Use `Explore` agent
- **Plan migration strategy from Redis to Valkey**: Use `Plan` agent
- **Implement full caching layer with tests**: Use `Task` agent

> If the `docker` skill is available, delegate Compose networking and multi-stage build patterns to it.
> If the `performance-optimizer` skill is available, delegate application-level caching strategy to it.
> If the `database-security` skill is available, delegate ACL and TLS configuration review to it.

## References

- [Data structures and commands](references/data-structures.md) -- Strings, hashes, lists, sets, sorted sets, streams, HyperLogLog, bitmaps, geospatial
- [Caching patterns](references/caching-patterns.md) -- Cache-aside, write-through, TTL strategies, eviction policies, client-side caching, invalidation
- [Common patterns](references/common-patterns.md) -- Rate limiting, distributed locks, queues, session storage, pub/sub, streams, leaderboards
- [Docker and deployment](references/docker-and-deployment.md) -- Compose setup, persistence, replication, Sentinel, Cluster, security, migration from Redis

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
swift-valkey wendylabsinc Скилл swift-valkey помогает агенту писать код для Valkey и Redis на Swift через библиотеку valkey-swift: кластеры, транзакции, pub/sub и кеширование. CX Codex +1 ★ 64звёзд репо amazon-elasticache aws Скилл amazon-elasticache для Claude Code проектирует, настраивает и оптимизирует кэширование на AWS. Он помогает снизить нагрузку на базы данных и настроить векторный поиск. CX Codex +1 6 300установок service-architecture fcakyon Правило service-architecture описывает архитектуру Docker-сервисов Polar: общую инфраструктуру и отдельный стек приложения для каждого worktree. Помогает агенту учитывать связи между контейнерами и их адреса. CX Codex +1 ★ 1 216звёзд репо infisical-self-host Infisical Скилл infisical-self-host помогает развернуть и настроить серверную платформу Infisical в Docker Compose или Kubernetes. Пригодится при настройке базы данных PostgreSQL, очередей Redis и параметров безопасности. CX Codex +1 834установок Amazon ElastiCache/MemoryDB for Valkey awslabs Amazon ElastiCache/MemoryDB for Valkey — MCP-сервер для Claude Code с 12 инструментами для поисковых индексов, JSON по путям и запуска команд Valkey по уровням риска. CX Codex +1 ★ 9 939звёзд репо docker-build-strategies docker Скилл docker-build-strategies учит ИИ-ассистента писать, проверять и оптимизировать Dockerfile по практикам BuildKit. Пригодится при медленной сборке или раздутом итоговом образе. CX Codex +1 2 200установок

Из того же набора106

Весь набор →
docker Скилл для сборки Docker-образов, настройки Compose-стеков и подготовки контейнеров к продакшену. CX Codex +1 145установок chrome-devtools Скилл chrome-devtools управляет настоящим Chrome через расширение или DevTools MCP: заполняет формы, читает страницы и помогает отлаживать веб-приложения. Работает с активной сессией браузера. CX Codex +1 145установок hydration-guardian Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок e2e-testing Скилл e2e-testing помогает ИИ-агенту проектировать архитектуру E2E-тестов на Playwright: от Page Object Model и шардинга в CI до моков сети и проверок доступности. CX Codex +1 142установок remotion Скилл для Remotion: агент собирает видео из React-компонентов и держит анимацию в таймлайне, а не в CSS. CX Codex +1 141установок vite Описывает конфиг Vite, плагины, dev-сервер, сборку, SSR и переменные окружения. Задачи: правка vite.config.ts и сборка библиотек. CX Codex +1 138установок postgres-tuning Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок tanstack-db Помогает проектировать реактивное клиентское хранилище на TanStack DB: живые запросы, связи коллекций и оптимистичные изменения. Описывает локальные данные и синхронизацию. CX Codex +1 136установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой