debug:laravel

Diagnose Laravel class, routing, and middleware errors with Artisan tooling.

9|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin --skill debug-laravel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug:laravel
Source: https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin/tree/main/plugins/debug-and-refactor/skills/debug-laravel
Command: npx skills add https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin --skill debug-laravel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers systematically debug Laravel applications by diagnosing common class/namespace errors, routing problems, and middleware failures. It provides a structured approach to identify root causes across logs, configuration, routes, and environment, reducing mean time to resolution.

Core Features & Use Cases

  • Structured debugging workflow: guides through root-cause investigation across logs, config checks, routes, and queue states.
  • Comprehensive issue coverage: addresses common Laravel problems such as SQLSTATE errors, 404/405 route issues, Blade template errors, middleware/auth problems, queue failures, and cache/session anomalies.
  • Environment-ready practices: supports development and production workflows with Laravel Telescope, Debugbar, and Artisan tooling.

Quick Start

Use the Laravel debugging skill to diagnose and fix issues in your application by following the guided four-phase approach and applying the recommended commands in context.

Frequently Asked Questions about debug:laravel

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

FAQPage Schema
How do I debug common Laravel routing errors and middleware failures?

To debug Laravel routing errors and middleware failures, use a structured workflow that investigates application logs, verifies route definitions, and checks middleware configurations to identify the root cause of 404 or 405 issues.

What is the best way to diagnose SQLSTATE errors in a Laravel web application?

The best way to diagnose SQLSTATE errors in a Laravel web application is to follow a systematic root-cause investigation across database configurations, environment settings, and query logs to isolate connection or syntax problems.

How do I troubleshoot Laravel queue job failures and caching problems?

Troubleshoot Laravel queue job failures and caching problems by inspecting queue states, clearing application caches with Artisan tooling, and reviewing logs to resolve session anomalies and stuck jobs.

Can I use Laravel Telescope and Debugbar for production environment debugging?

Yes, you can use Laravel Telescope and Debugbar for production environment debugging, as the approach supports both development and production workflows to systematically trace class errors, Blade template issues, and namespace problems.

Why does my Laravel application throw class or namespace errors after Composer installation?

Laravel applications throw class or namespace errors after Composer installation due to autoloading misconfigurations, which require a structured diagnostic approach across environment configurations and vendor namespaces to resolve.

What should I do when Blade template issues persist in my Laravel application?

When Blade template issues persist in your Laravel application, systematically debug by checking view rendering logs, validating middleware data passing, and using Artisan tooling to clear compiled view caches.