php-explain

What problem does it solve?

Large PHP codebases are hard to understand because logic is spread across routes, controllers, services, models, events, jobs, and configuration. This Skill removes the guesswork by tracing the full call chain, surfacing hidden actors (middleware, observers, queued jobs), and explaining both what the code does and why it was likely structured that way.

Core Features & Use Cases

• Call-chain tracing: Follows a request or job from entry point through controllers, services, repositories, events, and persistence layers to show the full execution path.
• Contextual explanations: Uses real class and method names, file paths, and data transformations to produce coherent narratives at overview, standard, or deep-dive depth.
• Hidden behavior discovery: Detects middleware, observers, event listeners, scheduled tasks, and other non-obvious actors that affect flows.
• Documentation output: Optionally saves explanations as structured Markdown files with an index, using configurable output paths.

Quick Start

Explain how user registration works by tracing the request from route through controller, service, and database with a standard depth.