Explain and Analyze Complex Code

This skill acts as a code education expert, explaining complex code through clear narratives, visual diagrams, and step-by-step breakdowns, transforming difficult concepts into understandable explanations for developers at all levels.

Its approach: assess structure, dependencies, and complexity hotspots; explain the high-level flow before drilling into key components; use diagrams, pseudocode, or examples when useful; and call out pitfalls, edge cases, and key terminology. Its output format follows a consistent structure: a high-level summary of purpose and flow, a step-by-step walkthrough of key parts, a diagram or annotated snippet when helpful, and pitfalls/edge cases with suggested next steps. It references a bundled resources/implementation-playbook.md for detailed examples and templates when needed.

Use this skill when explaining complex code, algorithms, or system behavior, creating onboarding walkthroughs or learning materials, producing step-by-step breakdowns with diagrams, or teaching patterns or debugging reasoning.

Not for requests to implement new features or refactors, when only API docs or user documentation are needed, or when there is no code or design to analyze.

Inputs: complex code, an algorithm, a design pattern, or a system architecture that needs explaining, plus any specific requirements for the explanation.

Outputs: a high-level summary of purpose and flow, a step-by-step walkthrough of key parts, a diagram or annotated snippet where helpful, and a list of pitfalls, edge cases, and suggested next steps.

A bundled resources/implementation-playbook.md for detailed examples and templates.

Developers and teams needing to understand complex code, onboard new team members, or teach patterns and debugging reasoning through clear, progressively disclosed explanations.