code-explanation — Claude Code skill: what it does, install
The code-explanation skill explains code, architecture, and system behavior at a depth that matches the reader. Use it for walkthroughs, teaching, and knowledge transfer.
MIT 173 installs ★ 71 updated 2026-06-29
npx skills add NickCrew/Claude-Cortex --skill code-explanation -a claude-codeWhat code-explanation does
The skill starts by defining the subject, audience level, and response format. It then studies the code or concept, builds the explanation in progressive layers, and adds examples where they help. A final pass checks whether the result is accurate and clear.
Its workflow points to skills/code-explanation/references/explain.md and skills/code-explanation/references/pedagogical-methodology.md. The output can include a structured explanation, stated assumptions, and follow-up notes. When the task is strictly documentation production, use documentation-production instead; this skill is built for explaining how something works.
What it helps with
- explain a function for a specific reader level
- walk through an application architecture
- clarify how a system behaves at runtime
- turn a code concept into a teaching explanation
- check an explanation against source behavior
Example prompts for the agent
- Explain how this function works for someone new to the project.
- Walk through the application architecture, starting with the high-level picture and then showing the details.
- Use
READMEto explain this project and verify the explanation against its behavior.
How to install code-explanation
1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill code-explanation -a claude-code2Manually: put the files in place
~/.claude/skills/code-explanation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/code-explanation/
1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill code-explanation -a codex2Manually: put the files in place
.agents/skills/code-explanation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill code-explanation -a cursor2Manually: put the files in place
.cursor/skills/code-explanation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NickCrew/Claude-Cortex skills/code-explanation2Manually: put the files in place
.github/skills/code-explanation/SKILL.md1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill code-explanation -a gemini-cli2Platform CLI
gemini skills install https://github.com/NickCrew/Claude-Cortex --path skills/code-explanationManually: put the files in place
.devin/skills/code-explanation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill code-explanation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about code-explanation
How do I install code-explanation in Claude Code?
Run npx skills add NickCrew/Claude-Cortex --skill code-explanation -a claude-code, then check ~/.claude/skills/code-explanation/SKILL.md.
What does code-explanation do?
It produces structured explanations of code, architecture, concepts, and system behavior. The skill adjusts depth for the intended audience and validates clarity and accuracy.
Which reference files does code-explanation use?
Its workflow uses skills/code-explanation/references/explain.md and skills/code-explanation/references/pedagogical-methodology.md.
Source text
SKILL.md · MIT
--- 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 1. Identify target, audience level, and format. 2. Load the explanation reference. 3. Analyze the code or concept. 4. Structure the explanation with progressive depth. 5. 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
© NickCrew · MIT · NickCrew/Claude-Cortex