redis

Execute read-only Redis commands against ByteCache clusters via the ByteCloud gateway.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill redis-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: redis
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/redis
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill redis-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers often need to inspect cached data in Redis (ByteCache) clusters spread across multiple regions, but manually resolving service names to clusters, picking the right gateway, and handling IAM permissions is slow and error-prone. This Skill automates that entire lookup-and-query flow. ## Core Features & Use Cases - Read-only command execution: Run validated Redis commands (GET, HGET, HGETALL, TTL, ZSCORE, and 100+ more) against ByteCache clusters through the ByteCloud gateway. - Automatic cluster resolution: Resolves a service PSM to the correct cluster and VRegion via ByteHeart deploy info, including alchemy-architecture handling. - Service discovery and command listing: Search for Redis services by keyword and list all commands supported by the API. - Use Case: You suspect a stale cache entry is causing a bug in production. Ask the agent to run HGETALL on the relevant key for your service in the China-North region and inspect the stored fields immediately. ## Quick Start Ask the agent to run a GET command on a specific key for your Redis service PSM, optionally specifying the target VRegion.

Frequently Asked Questions about redis

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

FAQPage Schema
How do I query a Redis key by service name?

Provide the service PSM, command, and key arguments to the agent, which resolves the PSM to the correct cluster automatically via ByteHeart deploy info. For example, run a GET command with service_name and args set to your key, optionally specifying a VRegion.

How do I find which Redis commands are supported?

Use the list_commands action to retrieve the full list of commands supported by the ByteCloud API. Commands are validated at runtime against this list rather than being hardcoded, covering 100+ read operations like GET, HGET, TTL, and ZRANGE.

Can I run write commands like SET or DEL on Redis clusters?

No, only read-only commands supported by the ByteCloud API are available through this gateway. Write operations are not permitted, keeping cache inspection safe for production environments.

Why do I get a 403 permission error when querying Redis?

A 403 error means the gateway denied access, usually because the request lacks the row_og_required_schema block or you are missing redis.resource.update permission on the cluster. Apply for the permission via IAM on the target cluster.

How do I query Redis in a specific region like China or EU?

Set the vregion parameter to the target region such as China-North, US-East, or EU-TTP2, and the agent routes through the correct gateway. Note that EU VRegions require non-restricted employee access via GCP.

What happens if my PSM is not deployed in the requested VRegion?

The agent returns an error listing the available VRegions for that PSM based on ByteHeart deploy info. You can also use the search_service action with a keyword to inspect the PSM and find its deployments.