explain-diff

explain-diff is an agent skill that turns Git diffs, pull requests, branch comparisons, or commit histories into self-contained HTML review documents.

Installation

npx skills add B-R-P/explain-diff

What is in this repo

skills/explain-diff/
├── SKILL.md                    # Instructions agents should follow
├── references/
│   ├── common-mistakes.md      # Catalog of HTML construction errors
│   └── red-flags.md            # Catalog of process rationalizations
└── scripts/
    ├── html_wrap.py            # Converts an HTML snippet into a complete document
    └── README.md               # Script-specific notes

What agents produce

When an agent uses this skill, it should create an HTML review with:

• An executive summary
• A before/after impact table
• Expandable file breakdowns
• A caveats & tradeoffs callout, even when it states “None identified”