> ## Documentation Index
> Fetch the complete documentation index at: https://www.opendirectory.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# explain-this-pr

> Point this skill at any GitHub PR and it writes a plain-English explanation of what changed and why, then posts it as a PR comment.

<Info>
  **Category:** Developer Tools · **Version:** `1.0.0` · **Author:** `OpenDirectory` · **Compatibility:** All targets (claude, codex, opencode, gemini, anti-gravity, openclaw, hermes)
</Info>

<img width="1280" height="640" alt="explain-this-pr" src="https://github.com/user-attachments/assets/9e76fc64-f982-4c4c-9b58-4398541aab97" />

Point this skill at any GitHub PR and it writes a plain-English explanation of what changed and why, then posts it as a PR comment.

## Install

<Tabs>
  <Tab title="npx CLI (Recommended)">
    ```bash theme={null}
    npx "@opendirectory.dev/skills" install explain-this-pr --target claude
    ```
  </Tab>

  <Tab title="skills.sh">
    ```bash theme={null}
    npx skills add Varnan-Tech/opendirectory --skill explain-this-pr
    ```
  </Tab>

  <Tab title="Claude Code Native">
    ```bash theme={null}
    /plugin marketplace add Varnan-Tech/opendirectory
    /plugin install opendirectory-gtm-skills@opendirectory-marketplace
    ```
  </Tab>

  <Tab title="Claude Desktop">
    <video controls className="w-full aspect-video rounded-xl mb-4" src="https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c" />

    1. Copy `https://github.com/Varnan-Tech/opendirectory/tree/main/skills/explain-this-pr` into [download-directory.github.io](https://download-directory.github.io/) to download the ZIP.
    2. Open **Claude Desktop** -> **Customize** -> **Skills** -> **+** -> **Upload a skill** and drop the folder containing `SKILL.md`.
  </Tab>

  <Tab title="Manus AI">
    <video controls className="w-full aspect-video rounded-xl mb-4" src="https://github.com/user-attachments/assets/17cbee2a-9e17-4bd4-ac46-68e0e92ffab4" />

    [**Install explain-this-pr in Manus AI**](https://manus.im/import-skills?githubUrl=https%3A%2F%2Fgithub.com%2FVarnan-Tech%2Fopendirectory%2Ftree%2Fmain%2Fskills%2Fexplain-this-pr\&utm_source=opendirectory)
  </Tab>
</Tabs>

## What It Does

* Fetches the PR diff and metadata via `gh`
* Writes two paragraphs: what changed (technical) and why it matters (impact)
* Posts the explanation as a PR comment with `gh pr comment`
* Works with any public or private repo you have access to via `gh`

## Requirements

| Requirement | Purpose | How to Set Up |
| - | - | - |
| `gh` CLI | Fetching PR data and posting comments | [https://cli.github.com](https://cli.github.com), then run `gh auth login` |

No API keys needed.

## How to Use

Explain a PR by URL:

```
"Explain this PR: https://github.com/owner/repo/pull/123"
"What does this PR do? https://github.com/owner/repo/pull/456"
"Summarize this pull request: [URL]"
```

Explain by PR number (in the current repo):

```
"Explain PR #42"
"Add a summary comment to PR #99"
```

Explain the current branch PR:

```
"Explain the current branch PR"
"Add a plain-English comment to my PR"
```

Output without posting:

```
"Explain this PR but don't post the comment: [URL]"
"What does this PR change? Just give me the text."
```

## Output Format

Two paragraphs, under 150 words total.

Paragraph 1: What it does (technical). Names the specific files, functions, or systems that changed. States the before/after if visible in the diff.

Paragraph 2: Why it matters (impact). Explains who benefits and what problem is solved. Omitted if there is no clear "why" in the diff or commits. The skill never guesses at impact.

## Project Structure

```
explain-this-pr/
├── SKILL.md
├── README.md
└── evals/
    └── evals.json
```

## License

MIT


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.