change-walkthrough

Walk through code changes from PRs, commit ranges, branches, or file lists.

1|Updated Jun 7, 2024
One-click install
npx skills add https://github.com/jsco2t/dotfiles --skill change-walkthrough
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: change-walkthrough
Source: https://github.com/jsco2t/dotfiles/tree/main/.claude/skills/change-walkthrough
Command: npx skills add https://github.com/jsco2t/dotfiles --skill change-walkthrough

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow provides an interactive, section-by-section walkthrough of code changes, helping engineers understand what changed and why without reading every line.

Core Features & Use Cases

  • Guide through diffs: Presents diffs from PRs, commit ranges, branches, or file lists in an organized, digestible flow.
  • Question-driven pauses: Pauses after each section to prompt questions and action items.
  • Final summary: Produces a concise summary of all decisions and flagged items for quick reference.
  • Use Case: Rapid onboarding of new contributors by demystifying changes in a PR.

Quick Start

Invoke the skill by supplying a target diff context (e.g., PR number, commit range, branch name, or file paths) to begin the guided walkthrough.

Frequently Asked Questions about change-walkthrough

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I walk through a git diff to understand code changes?▼

To walk through a git diff, supply a PR number, commit range, branch, or file list to generate a sectioned, interactive review explaining what changed and why.

Can I review a pull request interactively instead of reading every line?▼

Yes, you can review a pull request interactively by providing the PR number to receive a guided, sectioned walkthrough with question-driven pauses and action items.

How do I onboard new contributors to a codebase using commit history?▼

Onboard new contributors by using a commit range or branch name to generate an organized, digestible flow of code changes with a final summary of decisions.

Does this code review walkthrough work with specific file paths?▼

Yes, this code review walkthrough accepts explicit file paths as input, fetching relevant context from diffs and commit messages to deliver a structured review.

What is the best way to get a summary of decisions from a code review?▼

The best way to get a summary of decisions from a code review is to complete the interactive walkthrough, which produces a concise summary of all flagged items for quick reference.

Are there limitations when using a guided walkthrough for large branch diffs?▼

When using a guided walkthrough for large branch diffs, the process pauses after each section to prompt questions and action items, which may require significant time to complete.