Agent skill

Cache Debug

by zhyese in zhyese/grid-qa

排查问答缓存问题(不命中/脏缓存/黑名单误拦/置信度过滤/多轮不缓存)时使用。覆盖三级缓存(Redis/MySQL/Semantic)+黑名单+置信度规则。

Custom licenceAuto-check passedDatabases

Install Cache Debug

skills CLI
$ npx skills add zhyese/grid-qa --skill cache-debug -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zhyese/grid-qa cache-debug --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zhyese/grid-qa.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/cache-debug .claude/skills/cache-debug && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cache-debug
GitHub stars
144
Token cost
~646 tokens
SKILL.md length
132 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Custom licence

At a glance

排查问答缓存问题(不命中/脏缓存/黑名单误拦/置信度过滤/多轮不缓存)时使用。覆盖三级缓存(Redis/MySQL/Semantic)+黑名单+置信度规则。

  • Works in 7 steps: 该 query 真的没命中吗?看命中层 → key 对不对?查 Redis → 黑名单拦了吗? → …
  • Databases work in your project
  • SKILL.md covers 何时用, 排查清单(按顺序), 常见根因速查 and 关键代码位置(codegraph 核实)
  • Calls docker and redis-cli

What it does

Cache Debug is an agent skill from zhyese/grid-qa. 排查问答缓存问题(不命中/脏缓存/黑名单误拦/置信度过滤/多轮不缓存)时使用。覆盖三级缓存(Redis/MySQL/Semantic)+黑名单+置信度规则。

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases. It works with Redis and MySQL. The repository describes itself as: 基于大模型+RAG的电网自主运维智能问答系统(Vue3+FastAPI+Milvus+DeepSeek/百炼/火山云).

When your agent uses it

  • Databases work in your project

Example prompts

  • “/cache-debug”

Requirements

  • Docker

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 该 query 真的没命中吗?看命中层
  2. key 对不对?查 Redis
  3. 黑名单拦了吗?
  4. 为什么没写缓存?核对写条件
  5. 多轮不命中?
  6. MySQL L2 有吗?
  7. 降级了吗?

What it can do on your machine

Read from SKILL.md and the folder at commit 3b583b3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • docker
    • redis-cli

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cache Debug loads about 646 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 132 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~646

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 132 words (~646 tokens).

name
cache-debug

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/cache-debug of zhyese/grid-qa.

Open the folder on GitHubat commit 3b583b3

Compare with similar skills

Cache Debug next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cache Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cache Debug this skillzhyese/grid-qa144—~646Automated safety check: PassCustom licence
Email Blastantiwork/gumroad9.8k—~1.4kAutomated safety check: PassMIT
Tgf Server Devthkhxm/tgf128—~1.3kAutomated safety check: NotesMIT
Resume Backend Project OptimizerLAIJiangFeng/resume-builder247—~868Automated safety check: PassNone
Cloudrun DevelopmentTencentCloudBase/CloudBase-AI-Toolkit1.1k1 repos~7.2kAutomated safety check: PassMIT
Leaderboard SystemOpenLitterMap/openlittermap-web134—~2kAutomated safety check: PassGPL-3.0

Similar skills

  • Email Blast

    antiwork/gumroad

    Send one-off email blasts to Gumroad creators directly via production console, no PR or deploy needed.

    9.8k GitHub stars~1.4k tokensUpdated today
    DatabasesAuto-check passed
  • Tgf Server Dev

    thkhxm/tgf

    基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。

    128 GitHub stars~1.3k tokensUpdated 2 mo ago
    DatabasesAuto-check: notes
  • Resume Backend Project Optimizer

    LAIJiangFeng/resume-builder

    将中文后端项目经历改写为高质量、可面试追问、强数据化的简历要点。适用于用户提供“项目经历/主要工作/职责描述”后,要求按统一模板输出“负责xxx功能 + 关键技术细节组合 + 解决问题 + 数据化结果”的场景;适用于 Java 后端求职、简历优化、面试前项目复盘,且需要对齐面试高频考点(Java 集合与并发、MySQL、Redis、Spring、消息队列、系统设计等)时使用。

    247 GitHub stars~868 tokensUpdated 1 mo ago
    DatabasesAuto-check passed
  • Cloudrun Development

    TencentCloudBase/CloudBase-AI-Toolkit

    CloudBase Run backend development rules (Function mode/Container mode).

    1.1k GitHub starsUsed in 1 repo~7.2k tokens
    DatabasesAuto-check passed
  • Leaderboard System

    OpenLitterMap/openlittermap-web

    LeaderboardController, Redis sorted sets for all-time XP rankings, per-user metrics rows for time-filtered rankings, rewardXpToAdmin, and leaderboard privacy.

    134 GitHub stars~2k tokensUpdated 23 days ago
    DatabasesAuto-check passed
  • Metrics Pipeline

    OpenLitterMap/openlittermap-web

    MetricsService, RedisMetricsCollector, ProcessPhotoMetrics, metrics table, Redis stats, leaderboards, XP processing, and photo processing state (processedat/fp/tags/xp).

    134 GitHub stars~1.8k tokensUpdated 23 days ago
    DatabasesAuto-check passed

More from zhyese/grid-qa

  • Rebuild After Change

    zhyese/grid-qa

    改了项目代码/配置后,判断该 rebuild 哪个镜像、哪些走 HMR、.env 改动要不要重建容器。避免"改了没生效"的最常见坑。

    144 GitHub stars~463 tokensUpdated 3 days ago
    Auto-check: notes

Works with

Categories

Questions about Cache Debug

What does Cache Debug do?

排查问答缓存问题(不命中/脏缓存/黑名单误拦/置信度过滤/多轮不缓存)时使用。覆盖三级缓存(Redis/MySQL/Semantic)+黑名单+置信度规则。. Cache Debug is an agent skill from zhyese/grid-qa.

When should I use Cache Debug?

Cache Debug fits situations like: databases work in your project.

How do I install Cache Debug in Claude Code?

Run `npx skills add zhyese/grid-qa --skill cache-debug -a claude-code`. Or copy the skill folder (.claude/skills/cache-debug in zhyese/grid-qa) into .claude/skills/cache-debug in your project. Claude Code loads it when a task matches its description.

How do I install Cache Debug in Codex?

Run `npx skills add zhyese/grid-qa --skill cache-debug -a codex`. Or copy the skill folder (.claude/skills/cache-debug in zhyese/grid-qa) into .agents/skills/cache-debug in your project. Codex loads it when a task matches its description.

Can I use Cache Debug in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zhyese/grid-qa --skill cache-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cache-debug, .gemini/skills/cache-debug, .github/skills/cache-debug and .opencode/skills/cache-debug in your project.

What does Cache Debug need to run?

Going by SKILL.md and its folder, Cache Debug needs the command-line tools its instructions call (docker and redis-cli). Our summary lists: Docker.

Does Cache Debug access the network?

SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cache Debug safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cache Debug use?

Cache Debug has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Cache Debug use?

About 646 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cache Debug?

Skills that share tags, products or a category with Cache Debug: Email Blast (antiwork/gumroad, 9.8k stars), Tgf Server Dev (thkhxm/tgf, 128 stars), Resume Backend Project Optimizer (LAIJiangFeng/resume-builder, 247 stars) and Cloudrun Development (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cache Debug?

zhyese (a GitHub user) maintains it in zhyese/grid-qa, which has 144 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 4, 2026.

Source: zhyese/grid-qa on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.