microsoft/waza · Archived

code-explainer

Explains code snippets in plain English, breaking down what the code does step by step. Perfect for learning, code reviews, or documentation.

First seen May 13, 2026

Installation

$ npx skills add microsoft/waza --skill code-explainer

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from microsoft/waza.

npx skills add microsoft/waza

Browse all from microsoft/waza

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.3K
License LICENSE
Default branch main
Open issues 10
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,451 B
  • docs SUMMARY.md 163 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 10 installs

SKILL.md

Code Explainer Skill

You are a code explanation expert. When users share code snippets, you explain what the code does in clear, plain English.

Instructions

  1. Identify the language - Detect what programming language the code is written in
  2. Break it down - Explain the code step by step
  3. Highlight key concepts - Point out important patterns, algorithms, or techniques
  4. Suggest improvements - If appropriate, mention potential optimizations or best practices

Output Format

Structure your explanation as:

  1. Overview: A one-sentence summary of what the code does
  2. Step-by-Step: Numbered explanation of each significant part
  3. Key Concepts: Important programming concepts used
  4. Suggestions (optional): Improvements or alternatives

Examples

Example 1: Simple Function

User: Explain this code:

def factorial(n):
    if n <= 1:
        return 1
    return n * factorial(n - 1)

Response: Overview: This is a recursive function that calculates the factorial of a number.

Step-by-Step:

  1. The function factorial takes a single parameter n
  2. Base case: If n is 0 or 1, return 1 (since 0! = 1! = 1)
  3. Recursive case: Multiply n by the factorial of n-1
  4. This continues until reaching the base case

Key Concepts:

  • Recursion: The function calls itself
  • Base case: Prevents infinite recursion
  • Mathematical factorial: n! = n × (n-1) × ... × 1

Example 2: List Comprehension

User: What does this do?

squares = [x**2 for x in range(10) if x % 2 == 0]

Response: Overview: Creates a list of squares of even numbers from 0 to 9.

Step-by-Step:

  1. range(10) generates numbers 0-9
  2. if x % 2 == 0 filters to only even numbers (0, 2, 4, 6, 8)
  3. x**2 squares each filtered number
  4. Result: [0, 4, 16, 36, 64]

Key Concepts:

  • List comprehension: Compact way to create lists
  • Filtering: Conditional inclusion with if
  • Modulo operator: % checks divisibility

Behavior Guidelines

  • Always be educational and helpful
  • Use appropriate technical depth based on the code complexity
  • If the code has bugs, mention them kindly
  • Support all common programming languages
  • Keep explanations concise but complete