aw-create-walkthrough
SolidGenerate a walkthrough artifact (walkthrough.md) in `.agent/{branch}/` summarizing completed work for PR delivery. Gathers information from plan.md, git history, and test results to produce a comprehensive summary. Use at Phase 6 before creating the draft PR. Triggers on create walkthrough, generate walkthrough, write walkthrough artifact.
AI & Automation 13 stars
2 forks Updated yesterday MIT
Install
Quality Score: 86/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Create Walkthrough Artifact
Generate `.agent/{branch-name}/walkthrough.md` — the final summary for PR delivery.
---
## Prerequisites
Before invoking this skill:
1. All tests must be passing
2. Documentation must be updated
3. `plan.md` must exist and have an up-to-date Progress Log
4. You must be inside the worktree
---
## Procedure
### Step 1: Determine file location and gather information
Run this command to get the artifact path and gather git information — do NOT guess the branch name:
```bash
BRANCH=$(git branch --show-current) && mkdir -p ".agent/${BRANCH}" && echo "Artifact path: .agent/${BRANCH}/walkthrough.md" && echo "---" && git diff --stat main...HEAD && echo "---" && git log --oneline main...HEAD
```
**From plan.md** (read the file — must run in the same shell session as above, or re-assign `BRANCH`):
```bash
BRANCH=$(git branch --show-current) && cat ".agent/${BRANCH}/plan.md"
```
Extract: Summary, Decisions, Requirements, File Changes table.
**From test results:**
Recall or re-run the test suite to confirm current status.
### Step 2: Write walkthrough.md
Create the file at the path from Step 1 using the template below. **Do NOT hardcode or guess the branch name.**
### Step 3: Present to user
After writing the file, output the walkthrough content directly in the conversation so the user sees it immediately.
---
## Template
**All timestamps MUST use full ISO 8601 with time: `YYYY-MM-DDTHH:MM:SSZ`**
```markdown
---
created: { TIMESTAMP }
b...
Details
- Author
- mthines
- Repository
- mthines/agent-skills
- Created
- 4 months ago
- Last Updated
- yesterday
- Language
- JavaScript
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Featured
walkthrough
Generate a hands-on browser walkthrough of a PR's user-facing changes to exercise before review; --publish posts the final version to the PR for QA.
422 Updated 4 weeks ago
joshukraine AI & Automation Listed
pr-walkthrough
Generate an evidence-grounded markdown walkthrough for a pull request.
38 Updated 4 days ago
rp1-run AI & Automation Listed
code-walkthrough
Use when guiding a developer through unfamiliar codebases via step-by-step walkthroughs
4 Updated today
imMamdouhaboammar