laravel-debugging

Diagnose Laravel production performance issues via logs, queues, and database queries.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/billyfranklim1/claude-skills --skill laravel-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: laravel-debugging
Source: https://github.com/billyfranklim1/claude-skills/tree/main/plugins/laravel-debugging/skills/laravel-debugging
Command: npx skills add https://github.com/billyfranklim1/claude-skills --skill laravel-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly triage and resolve production issues in Laravel applications, including slow routes, N+1 queries, memory leaks, stalled or looping queue jobs, Horizon worker disappearance, and silent 500 errors by guiding systematic log inspection and remediation steps.

Core Features & Use Cases

  • Log Triage & Error Discovery: Locate and interpret Nginx, PHP-FPM, and Laravel logs to surface the root cause of silent failures and 500 responses.
  • Queue & Horizon Diagnostics: Inspect Horizon, supervisor/systemd workers, and queue backends (Redis/database) to identify stalled jobs, retry loops, and worker crashes.
  • Performance Profiling & DB Analysis: Identify N+1 queries and slow database operations, recommend indexes or query fixes, and suggest profiling checkpoints.
  • Use Case: Triage a production API showing intermittent 500s and slow endpoints: gather relevant logs, reproduce high-latency queries, find offending jobs in the queue, and propose prioritized fixes.

Quick Start

Inspect the Laravel app at api.myapp.example.com for slow requests, N+1 queries, failed or stalled queue jobs, and provide step-by-step remediation including log locations and recommended fixes.

Frequently Asked Questions about laravel-debugging

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

FAQPage Schema
How do I troubleshoot stalled queue jobs in Laravel Horizon?

To troubleshoot stalled Laravel Horizon queue jobs, inspect the Horizon dashboard for pending or failed jobs, check supervisor or systemd worker logs for crash reports, and examine Redis or database queue backends for retry loops to identify the root cause.

What is the best way to find N+1 queries causing slow Laravel routes?

The best way to find N+1 queries causing slow Laravel routes is to analyze database query logs, identify repeated model retrieval patterns, and apply eager loading fixes or recommend database indexes to optimize slow operations.

How do I locate the source of silent 500 errors in a Laravel production application?

To locate silent 500 errors in a Laravel production application, systematically inspect Nginx access and error logs, PHP-FPM pool logs, and Laravel storage logs to surface the underlying failures and trace root causes.

Can I use this approach to diagnose memory leaks in PHP-FPM Laravel applications?

Yes, you can diagnose memory leaks in PHP-FPM Laravel applications by monitoring worker memory consumption logs, profiling application performance checkpoints, and inspecting queue workers for looping jobs that exhaust allocated memory limits.

Why does my Laravel Horizon worker disappear under heavy load?

Laravel Horizon workers disappear under heavy load when supervisor or systemd processes crash due to memory exhaustion, uncaught exceptions in looping jobs, or Redis queue backend timeouts, requiring log inspection and configuration adjustments.

What should I check when Laravel queue workers crash but no errors appear in the application log?

When Laravel queue workers crash without application log entries, check supervisor or systemd service logs for process termination signals, inspect PHP-FPM error logs, and review Redis backend connection stability for silent retry loops.