debug

Diagnose and fix Drupal 11 code issues in custom modules and themes.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AJV009/drupal-devkit --skill debug-ajv009
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/AJV009/drupal-devkit/tree/main/plugins/drupal-core/skills/debug
Command: npx skills add https://github.com/AJV009/drupal-devkit --skill debug-ajv009

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix Drupal code-level issues such as hooks not firing, services not found, cache not invalidating, entities not loading, and routes returning 403/404. This skill complements the ddev skill. Use ddev for environment issues (containers, ports, PHP errors). Use this skill for Drupal code logic issues.

Core Features & Use Cases

  • Classify problems by symptom and provide targeted debugging steps for hooks, services, cache, entities, routes, and permissions.
  • Offer environment-aware guidance and commands for Drupal 11 code issues across development and debugging sessions.
  • Support in-context guidance during coding to diagnose logic errors in custom modules and themes.

Quick Start

Describe the issue you're seeing and share any error messages to receive category-specific debugging steps.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug Drupal hooks that are not firing in custom modules?

Debug Drupal hooks not firing by classifying the issue symptom to receive targeted diagnostic steps for hook implementation, naming conventions, and module weight conflicts within custom modules.

Why does my Drupal route return a 403 or 404 permission error?

Drupal routes returning 403 or 404 permission errors require category-aware debugging workflows that validate routing definitions, access arguments, and permission callbacks across your custom module environment.

What is the best way to fix Drupal services not found errors?

Fix Drupal services not found errors through environment-aware diagnostic steps that verify service container definitions, module dependencies, and namespace autoloading within your custom code.

How do I fix Drupal cache invalidation failures in custom themes?

Resolve Drupal cache invalidation failures by applying scripted diagnostic steps to identify missing cache metadata, incorrect cache tags, and contextual variations within custom theme logic.

Does this debugging approach work for Drupal 11 code logic issues?

Yes, this debugging approach provides environment-aware guidance and scripted diagnostic steps specifically applicable to resolving common Drupal 11 code logic issues across development sessions.

When should I use environment debugging versus Drupal code debugging?

Use environment debugging for infrastructure issues like containers or PHP errors, and apply Drupal code debugging specifically for logic issues like hooks not firing, entities not loading, or services not found.