tour

Explain code changes across Git and JJ diffs and pull requests.

2|Updated Jun 1, 2015

Search Tags:#git #code review #pull request #commit #diff #code understanding

Ready to run

npx skills add https://github.com/TimoFreiberg/dotfiles --skill tour-timofreiberg

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tour
Source: https://github.com/TimoFreiberg/dotfiles/tree/main/agents/skills/tour
Command: npx skills add https://github.com/TimoFreiberg/dotfiles --skill tour-timofreiberg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, in-depth explanation of code changes, helping users understand the 'what', 'why', and 'how' of modifications.

Core Features & Use Cases

Guided Diff Explanation: Walks through changes file-by-file, highlighting key decisions and areas for scrutiny.
Contextual Understanding: Integrates commit messages, PR details, and comments for a holistic view.
Use Case: When reviewing a complex Pull Request, use this Skill to get a concise yet thorough overview of the changes before diving into the code.

Quick Start

Use the tour skill to explain the uncommitted changes in the current repository.

Frequently Asked Questions about tour

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

FAQPage Schema

How do I understand complex code changes in a pull request?▼

A guided diff walkthrough explains modifications file-by-file, highlights key decisions, and flags areas requiring review. This provides a structured narrative to help you understand complex code changes in a pull request.

What is the best way to review uncommitted git diffs before committing?▼

Reviewing uncommitted git diffs is best done by generating a structured narrative that integrates contextual information and explains the rationale behind modifications. This highlights key decisions and flags areas needing scrutiny before you commit.

Does this code review tool work with both Git and JJ version control systems?▼

Yes, this code review tool works with both Git and JJ version control systems. It requires access to version control commands like git, jj, and gh, along with file reading capabilities to provide contextual information for diffs and commits.

Can I get a detailed explanation of a specific git commit's modifications?▼

Yes, you can get a detailed explanation of a specific git commit's modifications. The tool walks through changes file-by-file, integrating commit messages and contextual details to explain what was modified and the rationale behind key decisions.

Do I need GitHub CLI installed to analyze pull requests?▼

You need access to version control commands including git, jj, and gh to analyze pull requests. These commands and file reading capabilities are required to fetch PR details, comments, and file contents for a holistic contextual understanding.