debug-cache

Diagnose HybridCache and Redis caching issues in .NET applications.

15|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/aalmada/BookStore --skill debug-cache
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-cache
Source: https://github.com/aalmada/BookStore/tree/main/.claude/skills/debug-cache
Command: npx skills add https://github.com/aalmada/BookStore --skill debug-cache

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug HybridCache and Redis caching issues when data isn't cached or invalidated correctly, helping identify misconfigurations and timing problems that degrade performance.

Core Features & Use Cases

  • Cache health checks: verify HybridCache and Redis are configured and wired correctly.
  • Invalidation & consistency: ensure RemoveByTagAsync and GetOrCreateAsync keys align with mutations to avoid stale data.
  • Operational diagnostics: provide quick commands to verify Redis connectivity, cache keys, and expiration settings in real-world deployments.

Quick Start

Use this skill to guide debugging of cache issues in an ASP.NET Core application using HybridCache and Redis.

Frequently Asked Questions about debug-cache

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

FAQPage Schema
Why is my HybridCache returning stale data after database mutations in ASP.NET Core?

HybridCache returns stale data when RemoveByTagAsync calls do not align with GetOrCreateAsync key generation. This diagnostic process verifies tag invalidation and key alignment to ensure mutations properly clear outdated cached entries.

How do I diagnose Redis connectivity issues affecting my .NET HybridCache implementation?

Diagnose Redis connectivity issues by running operational checks that verify Redis configuration, test live connections, inspect cache keys, and validate expiration settings within real-world ASP.NET Core deployments.

What is the best way to check if HybridCache and Redis are configured correctly in .NET?

The best way to check configuration is through structured cache health checks that verify HybridCache and Redis are wired correctly, ensuring proper connection setup and cache hit or miss rates in ASP.NET applications.

How do I fix incorrect cache hit and miss rates when using HybridCache with Redis?

Fix incorrect cache hit and miss rates by applying a structured set of checks that validate proper cache configuration, key generation logic, and logging guidance to identify misconfigurations degrading performance.

Does this debugging workflow require any specific ASP.NET Core cache dependencies?

No specific dependencies are required. The diagnostic workflow applies directly to ASP.NET Core applications already implementing HybridCache and Redis to identify misconfigurations and timing problems without extra installations.

When should I not use HybridCache tag invalidation for cache consistency?

Tag invalidation fails when RemoveByTagAsync labels do not match GetOrCreateAsync keys. This diagnostic identifies these timing problems and misconfigurations to prevent stale data and degraded application performance.