# PR Description

Write and maintain pull request descriptions in this repository, including the required...

- Repository: https://github.com/OrchestratorInc/agent-orchestrator (13995 stars)
- Category: Git and review
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add OrchestratorInc/agent-orchestrator --skill pr-description -g -a claude-code -y`
Codex: `npx skills add OrchestratorInc/agent-orchestrator --skill pr-description -g -a codex -y`
Cursor: `npx skills add OrchestratorInc/agent-orchestrator --skill pr-description -g -a cursor -y`
Gemini CLI: `npx skills add OrchestratorInc/agent-orchestrator --skill pr-description -g -a gemini-cli -y`

## Description

Write and maintain pull request descriptions in this repository, including the required change-count header, the before-and-after section, and screenshots or recordings for visible changes.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# PR description

Use the section order in `.github/pull_request_template.md`: change-count header,
What, Why, Before / After, How, Testing, Checklist. Preserve the rest of an existing
PR description when updating it.

## Change-count header

Begin every PR description with these three lines, using Markdown hard line breaks
so each renders separately:

```text
Code changes: +<added> -<deleted>
Tests: +<added> -<deleted>
Others: +<added> -<deleted>
```

Calculate the numbers from the net diff against the PR's actual base. For a local
branch, use `git diff --numstat <base>...<head>`. After pushing, prefer GitHub's
per-file additions and deletions. Recalculate after the final push rather than
summing commit churn or estimating counts.

Count every changed file exactly once:

- **Code changes:** handwritten implementation, including SQL, migrations, styles,
  and executable scripts.
- **Tests:** test code, fixtures, snapshots, and test-only helpers.
- **Others:** generated or vendored files, lockfiles, documentation, configuration,
  and assets. Generated output belongs here even when it contains source code.

Show `+0 -0` for empty categories. Binary files have no line count; mention their
count separately when present. Add a brief qualifier when useful, such as
`Others: +11 -0 (generated sqlc)`.

## Before / After

Every PR has a `## Before / After` section with a two-column table, one row per
behavior that changed:

```markdown
| Before | After |
| --- | --- |
| ![Before: empty model list](before.png) | ![After: list filtered to six models](after.png) |
| `ao session ls` exits 1 when a project has no sessions | Prints `No sessions` and exits 0 |
```

The rest: https://github.com/OrchestratorInc/agent-orchestrator/blob/HEAD/.agents/skills/pr-description/SKILL.md