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

redis-inspect — скилл для Claude Code: что делает и как установить

Скилл redis-inspect для Claude Code проверяет ключи, значения и TTL в основном и системном инстансах Redis. Показывает, что сейчас хранится в кэше.

Apache-2.0 ★ 7 327 обновлён 2026-10-25

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

Что делает redis-inspect

Скилл даёт агенту обёртку над Redis: скрипт node .claude/skills/redis-inspect/query.mjs с подкомандами get, keys, ttl, type, exists, hgetall, hget, scard, smembers, llen, lrange, del и info. В keys маска задаётся со звёздочкой, а --limit обрезает вывод, по умолчанию до 100 записей.

Инстансов два. Основной кэш берётся из REDIS_URL; системный включается флагом --sys и читает REDIS_SYS_URL — там флаги фич, лимиты генераций и состояние задач. У ttl ответ -1 значит, что срок не выставлен, а -2 говорит, что ключа нет.

По умолчанию всё работает только на чтение. del срабатывает лишь с флагом --writable, и скилл требует сначала спросить разрешение у вас. Системный кэш хранит данные покритичнее основного, поэтому этот флаг стоит включать осознанно.

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

  • найти ключи по маске session:data2:* и проверить, есть ли сессия
  • посмотреть остаток TTL у счётчика генераций
  • вытащить все поля хэша с флагами фич
  • посчитать число элементов в множестве очереди
  • проверить память и состояние сервера Redis

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

  • Покажи первые 10 ключей по маске session:data2:* — надо понять, жива ли сессия пользователя.
  • Какой TTL у ключа generation:count:123?
  • Достань все поля system:features из системного кэша.

Как установить redis-inspect

1Через Skills CLI (Vercel)

npx skills add civitai/civitai --skill redis-inspect -a claude-code

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

~/.claude/skills/redis-inspect/SKILL.md

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

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

Вопросы о redis-inspect

Как установить redis-inspect в Claude Code?

Выполните npx skills add civitai/civitai --skill redis-inspect -a claude-code, после этого файл скилла лежит в ~/.claude/skills/redis-inspect/SKILL.md.

Что делает redis-inspect?

Читает ключи, значения, типы и TTL через query.mjs в основном кэше или в системном по флагу --sys. Операции записи закрыты, пока не передан --writable.

Чем системный кэш отличается от основного?

Основной это обычный кэш приложения в кластерном режиме: потерянные данные можно пересобрать. Системный живёт на одном узле и хранит конфигурацию и состояние, которые важнее.

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

SKILL.md · Apache-2.0
---
name: redis-inspect
description: Inspect Redis cache keys, values, and TTLs for debugging. Supports both main cache and system cache. Use for debugging cache issues, checking cached values, and monitoring cache state. Read-only by default.
---

# Redis Cache Inspector

Use this skill to inspect Redis cache state for debugging purposes.

## Running Commands

```bash
node .claude/skills/redis-inspect/query.mjs <command> [options]
```

### Commands

| Command | Description |
|---------|-------------|
| `get <key>` | Get a string value |
| `keys <pattern>` | Find keys matching pattern (use * as wildcard) |
| `ttl <key>` | Get TTL (-1 = no expiry, -2 = not found) |
| `type <key>` | Get the type of a key |
| `exists <key>` | Check if key exists |
| `hgetall <key>` | Get all fields from a hash |
| `hget <key> <field>` | Get a specific hash field |
| `scard <key>` | Get set cardinality (count) |
| `smembers <key>` | Get all set members |
| `llen <key>` | Get list length |
| `lrange <key>` | Get list elements |
| `del <key>` | Delete a key (requires --writable) |
| `info` | Get Redis server info |

### Options

| Flag | Description |
|------|-------------|
| `--sys` | Use system cache instead of main cache |
| `--writable` | Allow write operations (required for del) |
| `--json` | Output raw JSON |
| `--limit <n>` | Limit results (default: 100) |

## Cache Types

The project has two Redis instances:

| Cache | Flag | Env Variable | Purpose |
|-------|------|--------------|---------|
| **Main Cache** | (default) | `REDIS_URL` | Regular cache, cluster mode, can be lost |
| **System Cache** | `--sys` | `REDIS_SYS_URL` | Persistent system values, single node |

### Main Cache (default)
Regular application cache. Data here can be regenerated if lost.
- User sessions
- Cached queries
- Temporary data
- Rate limiting counters

### System Cache (--sys)
Persistent system configuration and state. More critical data.
- Feature flags
- Generation limits/status
- System permissions
- Job state
- Event configurations

## Examples

```bash
# Find keys matching a pattern
node .claude/skills/redis-inspect/query.mjs keys "user:*" --limit 20
node .claude/skills/redis-inspect/query.mjs keys "packed:caches:*"

# Get a value
node .claude/skills/redis-inspect/query.mjs get "session:data2:123456"

# Check system cache values
node .claude/skills/redis-inspect/query.mjs --sys get "system:features"
node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:entity-moderation"

# Check TTL
node .claude/skills/redis-inspect/query.mjs ttl "generation:count:123"

# Inspect a hash
node .claude/skills/redis-inspect/query.mjs hgetall "packed:caches:cosmetics"
node .claude/skills/redis-inspect/query.mjs hget "system:entity-moderation" "entities"

# Check set size
node .claude/skills/redis-inspect/query.mjs scard "queues:seen-images"

# Get server info
node .claude/skills/redis-inspect/query.mjs info
node .claude/skills/redis-inspect/query.mjs --sys info
```

## Common Key Patterns

### Main Cache
| Pattern | Description |
|---------|-------------|
| `user:*` | User data |
| `session:*` | Session data |
| `packed:caches:*` | Packed/compressed cached data |
| `packed:user:*` | Packed user cache |
| `generation:*` | Generation-related cache |
| `tag:*` | Tag cache |

### System Cache
| Pattern | Description |
|---------|-------------|
| `system:*` | System configuration |
| `generation:*` | Generation limits/status |
| `download:limits` | Download limits |
| `job:*` | Job state |
| `event:*` | Event configurations |
| `new-order:*` | New Order game state |
| `daily-challenge:*` | Daily challenge config |

## Debugging Tips

```bash
# Check if a user's session exists
node .claude/skills/redis-inspect/query.mjs keys "session:data2:*" --limit 10

# Check generation status
node .claude/skills/redis-inspect/query.mjs --sys get "generation:status"

# Check feature flags
node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:features"

# Check cache memory usage
node .claude/skills/redis-inspect/query.mjs info
```

## Write Operations

Write operations require `--writable` flag and user approval:

```bash
# Delete a specific key (requires approval)
node .claude/skills/redis-inspect/query.mjs del "some:key" --writable
```

**IMPORTANT**: Always ask the user for permission before using `--writable`.

© civitai · Apache-2.0 · civitai/civitai

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

Все скиллы по теме «Бэкенд и API» →
upstash-redis-js Upstash Скилл upstash-redis-js для Claude Code учит агента работать с библиотекой @upstash/redis в Next.js и edge runtimes. Подключается при настройке кэша, сессий, очередей и векторного поиска. CX Codex +1 24 600установок redis-expert personamanagmentlayer Скилл redis-expert для Claude Code помогает проектировать Redis-кэш, pub/sub и работу с потоками данных. Помогает добавлять Redis в приложение и разбирать его архитектуру. CX Codex +1 272установок node-inspect-debugger Hermes Agent Скилл node-inspect-debugger запускает отладчик Node.js с реальными брейкпоинтами, шагованием и доступом к переменным вместо console.log. Работает с любым Node-процессом: тесты, dev-сервер, Ink-компоненты. CX Codex +1 403установок redis-patterns affaan-m Скилл redis-patterns для Claude Code собирает паттерны Redis для кэширования, распределённых блокировок, rate limiting и стримов. CX Codex +1 6 500установок redis-core Redis, Inc. Скилл redis-core подсказывает агенту, какой тип данных Redis выбрать под задачу и как назвать ключи. Пригодится при проектировании кэша, счётчиков и сессий. CX Codex +1 4 600установок redis-connections Redis, Inc. Скилл redis-connections, который подсказывает агенту, как правильно настроить клиент Redis: пул соединений, пайплайны, таймауты и кэш на стороне клиента. CX Codex +1 3 200установок

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

Весь набор →
quick-mockups Скилл quick-mockups для Claude Code: генерирует от 3 до 5 параллельных вариантов интерфейса в HTML для сравнения разных сеток и подачи новой фичи. CX Codex +1 1 700установок meilisearch-admin Скилл meilisearch-admin для мониторинга Meilisearch: проверяет индексы, задачи, здоровье сервера и настройки поиска. Помогает отловить ошибки в индексировании и понять, что происходит с поиском. CX Codex +1 132установок postgres-query Скилл postgres-query для Claude Code выполняет запросы к PostgreSQL при отладке и профилировании базы данных. Запускает команды через скрипт с обязательным указанием контура --prod или --dev. CX Codex +1 105установок agent-review Скилл agent-review для Claude Code отправляет код на проверку внешнему AI-агенту. Выполняет ревью, помогает оценить архитектурные решения и получить второе мнение. CX Codex +1 3установок discord Отправляет сообщения, анонсы и эмбеды в каналы Discord через REST API. Передаёт уведомления о релизах и командную переписку из консоли. CX Codex +1 ★ 7 327звёзд репо clickhouse-query Скилл clickhouse-query гоняет ad-hoc запросы к ClickHouse прямо из чата с агентом: метрики, события, план выполнения. По умолчанию только чтение. CX Codex +1 ★ 7 327звёзд репо postgres-query Скилл postgres-query выполняет SQL-запросы к PostgreSQL, запускает EXPLAIN ANALYZE и проверяет индексы через агент в безопасном режиме чтения. CX Codex +1 ★ 7 327звёзд репо browser-automation Скилл browser-automation для Claude Code запускает браузер через HTTP-сервер, сохраняет авторизацию и поддерживает несколько сессий. Проверяет пользовательские потоки и повторяемые сценарии. CX Codex +1 ★ 7 327звёзд репо

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

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