drupal-cache-debugging

Diagnose Drupal caching issues via X-Drupal-Cache headers and cache tags.

3|5|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/sparkfabrik/sf-awesome-copilot --skill drupal-cache-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drupal-cache-debugging
Source: https://github.com/sparkfabrik/sf-awesome-copilot/tree/main/skills/drupal/cache/drupal-cache-debugging
Command: npx skills add https://github.com/sparkfabrik/sf-awesome-copilot --skill drupal-cache-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drupal caching pitfalls like anonymous vs authenticated content, stale renders after edits, and misconfigured headers that degrade performance. This guide helps identify, analyze, and resolve such issues quickly.

Core Features & Use Cases

  • Diagnose X-Drupal-Cache and X-Drupal-Dynamic-Cache headers to distinguish Page Cache vs Dynamic Cache outcomes.
  • Inspect cache tags, contexts, and max-age to validate invalidation and fresh content delivery.
  • Provide reproducible debugging steps and best practices for cache profiling in Drupal projects.

Quick Start

Run a targeted cache health check on a Drupal page to verify correct cache behavior and identify the first failing step.

Frequently Asked Questions about drupal-cache-debugging

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

FAQPage Schema
How do I debug stale content and caching issues in Drupal?

Debug stale Drupal content by inspecting X-Drupal-Cache headers, validating cache tags, contexts, and max-age, and running targeted cache health checks to identify the first failing step in page delivery.

What do X-Drupal-Cache and X-Drupal-Dynamic-Cache headers tell me?

X-Drupal-Cache and X-Drupal-Dynamic-Cache headers distinguish Page Cache versus Dynamic Cache outcomes, revealing whether anonymous or authenticated user requests are serving cached or fresh content.

How do I validate Drupal cache invalidations after editing content?

Validate Drupal cache invalidations by inspecting cache tags, contexts, and max-age to ensure edits trigger proper invalidation and deliver fresh content instead of stale renders.

Can I diagnose authenticated vs anonymous user cache behavior in Drupal?

Diagnose authenticated versus anonymous Drupal cache behavior by applying reproducible debugging steps to analyze dynamic cache behavior and identify misconfigurations that degrade performance.

What is the best way to profile Drupal cache performance safely?

Profile Drupal cache performance safely by establishing clear, reproducible testing configurations and leveraging core cache APIs to inspect headers and validate correct cache behavior.

Why does my Drupal site serve stale renders after content updates?

Stale renders occur when Drupal cache invalidation fails to trigger properly; inspect cache tags, contexts, and max-age values to diagnose and resolve the misconfigured cache behavior.