Skip to main content

Claude Code

Skills​

  • Are markdown files that your agent can use to recognise specific scenarios and apply your reasoning to them.
  • I deal for moments when you find yourself repeating yourself, explaining how you want claude code to do something.
  • An example could be writing a commit message to git, you may have a specific style in your workflow and this would be perfect for that.
  • You can have a skills.md file either in your home directory (~/.claude/skills/{the skill}/SKILL.md) or in your root project directory following the same format.
  • In the home directory it applies across all projects whereas the other one is project specific.
---
name: explain-code
description: Explains code with visual diagrams and analogies. Use when explaining how code works, teaching about a codebase, or when the user asks "how does this work?"
---

When explaining code, always include:

1. **Start with an analogy**: Compare the code to something from everyday life
2. **Draw a diagram**: Use ASCII art to show the flow, structure, or relationships
3. **Walk through the code**: Explain step-by-step what happens
4. **Highlight a gotcha**: What's a common mistake or misconception?

Keep explanations conversational. For complex concepts, use multiple analogies.