visual-recap

Convert Git diffs into interactive visual recap documents for review.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/Omniloy/agent-skills --skill visual-recap-omniloy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-recap
Source: https://github.com/Omniloy/agent-skills/tree/main/skills/visual-recap
Command: npx skills add https://github.com/Omniloy/agent-skills --skill visual-recap-omniloy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps reviewers understand substantial code changes without starting from a raw line-by-line diff. It turns a completed branch, pull request, or commit into a structured recap that surfaces what changed, why it changed, and where to look first.

Core Features & Use Cases

  • Interactive review artifacts: Creates hosted, annotatable recaps that present the change as a navigable plan instead of a plain text summary.
  • Diff-aware structure: Organizes large changes into wireframes, file trees, schema and API blocks, and focused split diffs so reviewers can inspect the most important parts quickly.
  • Best for complex changes: Useful for UI updates, architecture shifts, multi-file refactors, contract changes, and release notes for work that needs clearer review context.
  • Privacy-aware local mode: Supports a local-files workflow when the user needs recaps kept off the hosted Plan database.

Quick Start

Create a visual recap for the current pull request or branch diff and publish the interactive plan.

Frequently Asked Questions about visual-recap

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

FAQPage Schema
How do I turn a pull request diff into a visual recap for code review?

A visual recap organizes large multi-file pull request diffs into structured, interactive review artifacts. It uses diff-aware wireframes, file trees, and annotated split diffs to help reviewers understand substantial code changes without reading raw line-by-line diffs.

What is the best way to review large multi-file refactors and architecture shifts?

Reviewing large multi-file refactors is best handled by generating an interactive visual recap that structures changes into schema blocks and focused split diffs. This surfaces API contract shifts and architecture work clearly, preventing reviewers from getting lost in raw text.

Can I generate visual recaps for local files without hosting them on a database?

Yes, you can generate visual recaps using a privacy-aware local-files workflow. This mode keeps your diff recaps entirely off the hosted Plan database, ensuring sensitive code changes and review artifacts remain strictly local to your environment.

How does a visual recap handle UI updates and API contract changes?

A visual recap handles UI updates and API contract changes by applying diff-aware wireframes and structured schema blocks. This renders before-and-after states clearly, making it easier to inspect interface modifications and contract shifts during review.

When should I avoid using plain text summaries for pull request reviews?

You should avoid plain text summaries for pull request reviews when dealing with complex changes like architecture shifts, schema updates, or multi-file refactors. These substantial modifications require structured visual recaps with wireframes and file trees to provide proper review context.