By name: code-explanation description: Use when explaining code, concepts, or system behavior to a specific audience level - provides a structured explanation workflow with depth control and validation steps. keywords: - code explanation - explain architecture - explain code - explain function - explain this code - how does this work - teach code - walkthrough file_patterns: - '/CODE_OF_CONDUCT' - '/CONTRIBUTING' - '/README' - '*/docs/' - '/guides/**' confidence: 0.72
Code Explanation
Overview
Provide clear explanations of code and concepts with appropriate depth, structure, and examples. Adapt the output to the audience level.
When to Use
- Explaining code, architecture, or system behavior
- Producing educational explanations for knowledge transfer
- Clarifying framework or domain concepts
Avoid when:
- The request is strictly documentation generation (use documentation-production)
Quick Reference
| Task | Load reference |
|---|---|
| Explanation workflow | skills/code-explanation/references/explain.md |
| Pedagogical Methodology | skills/code-explanation/references/pedagogical-methodology.md |
Workflow
- Identify target, audience level, and format.
- Load the explanation reference.
- Analyze the code or concept.
- Structure the explanation with progressive depth.
- Validate accuracy and clarity.
Output
- Structured explanation with examples
- Notes on assumptions and follow-ups
Common Mistakes
- Skipping audience level calibration
- Explaining without verifying source behavior