brief

Generate a one-pager summary of pull request changes with code tour.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/ilamanov/skills --skill brief-ilamanov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brief
Source: https://github.com/ilamanov/skills/tree/main/skills/brief
Command: npx skills add https://github.com/ilamanov/skills --skill brief-ilamanov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, github-api, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of reviewing code changes in pull requests, providing a visual HTML one-pager summary to aid decision-making and merge approvals.

Core Features & Use Cases

  • Automated PR Summarization: Generates a one-pager summary that highlights key changes and flags high-stakes modifications.
  • Two Modes: Auto-detects draft or final state to provide the appropriate summary for review or merge stages.
  • Code Tour: Guides the reviewer through important code changes with inline diff snippets for clarity.
  • Use Case: Ideal for busy managers who need a concise summary of code changes before approving or merging pull requests.

Quick Start

Generate a PR summary using the 'brief' skill and review the provided one-pager for the pull request under consideration.

Frequently Asked Questions about brief

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

FAQPage Schema
How do I review a pull request without reading raw diffs?

Review pull requests without reading raw diffs by generating a visual HTML one-pager summary. This approach highlights key modifications and flags high-stakes changes, enabling quick merge approvals.

Can I get a code tour for high-stakes modifications in a PR?

Yes, you can get a code tour for high-stakes modifications in a PR. The generated summary guides reviewers through important code changes using inline diff snippets for clarity.

How do I generate an HTML summary of code changes for PR review?

Generate an HTML summary of code changes for PR review by running the provided Python scripts. The automated process detects the PR state and outputs a visual one-pager.

Do I need Python and GitHub API access to automate PR summarization?

Yes, you need Python and GitHub API access to automate PR summarization. The skill relies on Python scripting and GitHub API dependencies to process pull requests and generate summaries.

Does the tool distinguish between draft and final states for merge gate processing?

Yes, the tool distinguishes between draft and final states for merge gate processing. It auto-detects the PR state to provide the appropriate summary for review or merge stages.