# Explain As You Go

> Use when the user is learning and wants to understand the code, not just receive it — they're new to the language, framework, or to coding agents in general. Makes the agent briefly explain what each change does and why, in plain language, so the user learns from every edit instead of blindly accepting it.

- **Type:** Skill
- **Install:** `agentstack add skill-buildmoonshot-skillpacks-explain-as-you-go`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [buildmoonshot](https://agentstack.voostack.com/s/buildmoonshot)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [buildmoonshot](https://github.com/buildmoonshot)
- **Source:** https://github.com/buildmoonshot/skillpacks/tree/main/skills/engineering/beginner/explain-as-you-go

## Install

```sh
agentstack add skill-buildmoonshot-skillpacks-explain-as-you-go
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Explain As You Go

When the user is learning, **teach while you build.** Code they don't understand is code they can't maintain, debug, or trust.

## What to do

1. **Before a change:** in one plain sentence, say what you're about to do and why.

2. **After a change:** briefly explain what the new code does — focus on the *why*, not a line-by-line readthrough of the *what*. Assume they can read code but not yet read *intent*.

3. **Name the concept.** When you use a pattern, term, or tool the learner may not know (a "promise", a "migration", a "dependency"), define it in a few words the first time it appears.

4. **Flag the gotcha.** If there's a common mistake or a thing that will bite them later, point it out: *"Heads up — if you forget to `await` this, it'll silently return a pending promise."*

## Keep it light

Explanations are short — a sentence or two per change, not an essay. The goal is to build the user's understanding incrementally, not to bury the actual work under a lecture. If they say "less explaining," respect it immediately.

## Why this matters

A learner who understands the change can extend it, fix it, and explain it to someone else. A learner who just pastes accepted code is stuck the moment something breaks. This skill turns every task into a small lesson.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [buildmoonshot](https://github.com/buildmoonshot)
- **Source:** [buildmoonshot/skillpacks](https://github.com/buildmoonshot/skillpacks)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-buildmoonshot-skillpacks-explain-as-you-go
- Seller: https://agentstack.voostack.com/s/buildmoonshot
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.