valkey-skills

valkey-skills

AI skills for the Valkey ecosystem. Teaches coding assistants what they don't know from training data - Valkey 9.x commands, GLIDE client APIs, operational defaults, and server internals.

15 skills, 281 files, source-verified against actual Valkey/GLIDE source code. Works with Claude Code, Cursor, Codex, Copilot, Gemini CLI, OpenCode, Kiro, and any tool supporting the Agent Skills standard.

Why

AI models are trained on snapshots of the internet. Valkey-specific features - COMMANDLOG, SET IFEQ, HSETEX/HGETEX, DELIFEQ, CLUSTERSCAN - don't exist in training data. Without skills, models default to Redis 7.x answers.

GLIDE has different method signatures, argument orders, and async patterns than every Redis client it replaces. Migration code generated from Redis knowledge doesn't compile.

Skills fix this. Benchmarked, measured, proven.

Benchmarks

Tested on Sonnet 4.6 and Opus 4.6 (Bedrock). Isolated workspaces, no web access, no shared context. Each condition ran multiple times. Skills that showed no value were removed.

Skill	Task	Model	Without	With	Delta
valkey	10 Valkey 9.x problem-solving scenarios	Sonnet	6/14	10/14	+4
valkey	Same	Opus	5/14	10/14	+5
valkey-dev	Find and fix cluster split-brain bug in ~200 C files	Sonnet	8/12	11/12	+3
valkey-ops	Helm chart for 6-node Valkey cluster on K8s	Opus	16/19 ($2.50)	18/19 ($1.57)	+2, 37% cheaper
valkey-ops	Config audit migrated from Redis 7.2	Sonnet	16/22	17/22	+1

Three skills were cut after benchmarking: valkey-module-dev (Rust crate already in training data), valkey-json-dev (C++ navigable without skills), and a query syntax skill (identical to RediSearch). We don't pad the count.

Full results in benchmarking.md.

Install

Claude Code

/plugin marketplace add avifenesh/valkey-skills
/plugin install valkey-skills@valkey-skills

Agent Skills CLI (cross-tool)

npx skills add avifenesh/valkey-skills

Works with Cursor, Copilot, Gemini CLI, OpenCode, Kiro, and any tool supporting the Agent Skills standard.

Codex CLI

git clone https://github.com/avifenesh/valkey-skills.git
codex --plugin-dir ./valkey-skills

Manual

Clone and copy to your tool's skills directory:

Tool	Copy to
Claude Code	~/.claude/skills/ or --plugin-dir ./valkey-skills
Codex CLI	~/.codex/skills/
Cursor	.cursor/skills/
OpenCode	~/.config/opencode/skills/
Kiro	.kiro/skills/

Skills

Application Development

Skill	Audience	Files
valkey	App developers - Valkey 9.x features, patterns, best practices	41

GLIDE Per-Language

Skill	Language	Files
valkey-glide-python	Python (async + sync)	9
valkey-glide-java	Java (CompletableFuture)	9
valkey-glide-nodejs	Node.js / TypeScript	9
valkey-glide-go	Go (synchronous, CGO)	9
valkey-glide-csharp	C# (.NET 8.0+)	4
valkey-glide-php	PHP 8.1+	4
valkey-glide-ruby	Ruby	4

Migration

Skill	From	To
migrate-redis-py	redis-py	GLIDE Python
migrate-jedis	Jedis	GLIDE Java
migrate-lettuce	Lettuce	GLIDE Java
migrate-ioredis	ioredis	GLIDE Node.js
migrate-go-redis	go-redis	GLIDE Go
migrate-stackexchange	StackExchange.Redis	GLIDE C#
spring-data-valkey	Spring Data Redis	Spring Data Valkey

Operations

Skill	Audience	Files
valkey-ops	Self-hosted operators - K8s, Helm, monitoring, security, config migration	61

Server and Module Development

Skill	Audience	Files
valkey-dev	Server contributors - C internals, data structures, threading, cluster, replication	65
valkey-search-dev	valkey-search contributors - C++, vector/text indexes, query engine	21
valkey-bloom-dev	valkey-bloom contributors - Rust, scalable bloom filters	13
glide-dev	GLIDE core contributors - Rust core, FFI bindings, build system	7

Message Queues

Skill	Purpose	Files
glide-mq	Queues, workers, schedulers, workflows on Valkey	3

How It Works

Each skill follows a router pattern. The AI loads only the frontmatter (name, description, trigger phrases) into context at startup. When it encounters a relevant question, it loads the full SKILL.md router, scans the routing table, and reads only the specific reference file it needs.