AGENT SKILL

code-explainer

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

License 许可
MIT
所属仓库
zuwasi/wazatator
最近更新
2026-10-05
Stars
★ 2
Forks
1

01 前言 Front Matter

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

03 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

04 同仓库更多 Skills

zuwasi
zuwasi/wazatator

waza-runner

Run evaluations on Agent Skills to measure their effectiveness. USE FOR: "run skill evals", "evaluate my skill", "test skill quality", "check skill triggers", "skill compliance check", "measure skill performance", "run evals on [skill-name]", "grade skill execution". DO NOT USE FOR: writing skills (use skill-authoring), improving frontmatter (use sensei), or general testing unrelated to skills.

★ 2
zuwasi
zuwasi/wazatator

waza

**WORKFLOW SKILL** - Evaluate AI agent skills using structured benchmarks with YAML specs, fixture isolation, and pluggable validators. USE FOR: run waza, waza help, run eval, run benchmark, evaluate skill, test agent, generate eval suite, init eval, compare results, score agent, agent evaluation, skill testing, cross-model comparison. DO NOT USE FOR: improving skill frontmatter (use waza dev), creating new skills from scratch (use skill-creator), token counting or budget checks (use waza tokens). INVOKES: Copilot SDK executor, mock engine, code/regex validators. FOR SINGLE OPERATIONS: use waza run directly for a single benchmark.

★ 2
zuwasi
zuwasi/wazatator

waza-interactive

Interactive workflow partner for creating, testing, and improving AI agent skills with waza. USE FOR: run my evals, check my skill, compare models, create eval suite, debug failing tests, is my skill ready, ship readiness, interpret results, improve score. DO NOT USE FOR: general coding, non-skill work, writing skill content (use skill-authoring), improving frontmatter only (use sensei).

★ 2
zuwasi
zuwasi/wazatator

code-explainer

**UTILITY SKILL** - Explain code snippets, functions, and algorithms in plain language. USE FOR: explain code, what does this code do, break down this function, help me understand this, walk through this algorithm, clarify this logic, explain this snippet, describe what happens here. DO NOT USE FOR: writing new code (use code generation), fixing bugs (use debugging), refactoring (use refactoring skills), code review with action items. INVOKES: file reading tools to access code, language detection for tailored explanations. FOR SINGLE OPERATIONS: If the user just needs to see file contents, use file reading tools directly.

★ 2
zuwasi
zuwasi/wazatator

profile-test-skill

**PROFILE TEST** - A skill for testing the profile command. USE FOR: testing profile analysis, verifying structural metrics. DO NOT USE FOR: production use.

★ 2
zuwasi
zuwasi/wazatator

count

暂无简介

★ 2