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 |
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