chess-teacher-redis

Inspect Redis cache keys, TTLs, and memory usage with read-only redis-py commands.

1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/daniel-brus/chess_teacher --skill chess-teacher-redis-daniel-brus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chess-teacher-redis
Source: https://github.com/daniel-brus/chess_teacher/tree/main/.agents/skills/chess-teacher-redis
Command: npx skills add https://github.com/daniel-brus/chess_teacher --skill chess-teacher-redis-daniel-brus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires redis, and includes scripts (resource) components.

What problem does it solve? Debugging cache behavior in the chess_teacher app requires safe, read-only access to Redis without risking accidental writes or deletions against local or production instances. ## Core Features & Use Cases - Connectivity and Health Checks: Run PING, DBSIZE, and memory INFO summaries against any configured Redis endpoint. - Key Inspection: SCAN for user cache keys, check existence, and read TTL, type, and size metadata for user:{id}:games:v1 and user:{id}:accounts:v1 keys. - Use Case: A user asks whether a player's games are cached. The agent runs the script via Doppler with the correct config, checks exists and key-info for that user's keys, and reports TTL and size in plain language. ## Quick Start Ask the agent to check whether Redis is reachable and list cached keys for a specific user ID.

Frequently Asked Questions about chess-teacher-redis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if Redis is reachable from Python?▼

Run the redis_query.py script with the ping command via Doppler, which executes a read-only PING against the REDIS_URL endpoint. The JSON output reports the endpoint, database index, and whether the ping succeeded.

How to list Redis keys matching a pattern without KEYS?▼

Use the scan command, which wraps redis-py scan_iter with a match pattern and limit. It defaults to the user:* pattern and avoids the blocking KEYS command, making it safe for production caches.

Can this skill modify or delete Redis cache entries?▼

No. The skill is strictly read-only and only permits PING, INFO, DBSIZE, SCAN, EXISTS, TTL, TYPE, and STRLEN. Write commands like SET, DEL, FLUSHDB, and CONFIG SET are explicitly forbidden.

Why does the script fail with REDIS_URL is not set?▼

The script reads REDIS_URL from the environment, which is injected by running through Doppler with a config such as dev_local or prod. Without Doppler, you need a populated local .env file, and the local Compose stack must be started with make dev_infra.

Can I view the actual cached value of a Redis key?▼

Only for small JSON accounts keys ending in :accounts:v1, using key-info with the --show-value flag. Games keys contain Parquet-encoded binary blobs, so only their type, TTL, and size in bytes are reported.