Standard collaboration patterns for all squad agents — worktree awareness, decisions, cross-agent communication
The English summary is being prepared. Showing the original description.
microsoft/waza1.4KUpdated Oct 19, 2026
FreePublished on GitHub
code-explainer
Explains code snippets in plain English, breaking down what the code does step by step. Perfect for learning, code reviews, or documentation.
The English summary is being prepared. Showing the original description.
See how to installFiles included (1)
- SKILL.md2.4 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
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
- Identify the language - Detect what programming language the code is written in
- Break it down - Explain the code step by step
- Highlight key concepts - Point out important patterns, algorithms, or techniques
- Suggest improvements - If appropriate, mention potential optimizations or best practices
Output Format
Structure your explanation as:
- Overview: A one-sentence summary of what the code does
- Step-by-Step: Numbered explanation of each significant part
- Key Concepts: Important programming concepts used
- 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:
- The function
factorialtakes a single parametern - Base case: If
nis 0 or 1, return 1 (since 0! = 1! = 1) - Recursive case: Multiply
nby the factorial ofn-1 - 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:
range(10)generates numbers 0-9if x % 2 == 0filters to only even numbers (0, 2, 4, 6, 8)x**2squares each filtered number- 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
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
azd-publish
FreePrepare and publish a new version of the waza azd extension. USE FOR: "publish extension", "release new version", "bump version", "prepare release", "update changelog", "azd publish", "new release", "version bump", "cut a release". DO NOT USE FOR: running evals (use waza), writing skills (use skill-authoring), CI/CD pipeline changes (edit workflow files directly).
The English summary is being prepared. Showing the original description.
microsoft/waza1.4KUpdated Oct 19, 2026
code-explainer
Free**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.
The English summary is being prepared. Showing the original description.
microsoft/waza1.4KUpdated Oct 19, 2026
The complete two-phase Init Mode protocol the Squad coordinator runs when no team exists yet in the current repo. Phase 1 = propose the team (no files created, wait for user confirm). Phase 2 = create .squad/ scaffolding, casting state, .gitattributes for merge drivers, and the always-on built-ins (Scribe, Ralph, Rai, Fact Checker). Loaded on demand when the coordinator detects no .squad/team.md exists.
The English summary is being prepared. Showing the original description.
microsoft/waza1.4KUpdated Oct 19, 2026
Selecting WHO handles work is the Routing table; selecting HOW they handle it (Direct, Lightweight, Standard, Full) is Response Mode. This skill contains the complete decision table, exemplar prompts for each mode, the Lightweight spawn template, and the upgrade rules. Squad coordinator loads this on demand once routing has identified the agent — to pick the right ceremony level for the task.
The English summary is being prepared. Showing the original description.
microsoft/waza1.4KUpdated Oct 19, 2026
The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.
The English summary is being prepared. Showing the original description.
microsoft/waza1.4KUpdated Oct 19, 2026