# Pr

> Create a draft pull request for the Vision-Agents repo using gh CLI.

- Skill: `getstream/pr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add getstream/pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/getstream/pr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: getstream (https://skillmd.com/u/getstream)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/getstream/pr

---


# Pull Request (Vision-Agents)

## Before creating

- Run `git log main..HEAD --oneline`. If the branch contains more than one independent logical change, STOP and ask the user whether to split it before proceeding.
- Run `uv run --no-sync dev.py check`. Skip if the diff does not touch Python code (`*.py`) or `pyproject.toml` — e.g. docs-only, `.gitignore`, `.github/`, or `.claude/` changes.
- Do not run integration tests locally, CI handles them.
- If the change is user-facing (public API break, new feature, bug fix), update `CHANGELOG.md` per the rules in `CLAUDE.md`.

## Creating

- Always `gh pr create --draft`. Push the branch first.
- Follow `.github/pull_request_template.md`. Read every commit on the branch, do not summarise from the latest commit alone.
- `## Why` is motivation + context. `## Changes`, if included, is high-level; never per-bullet justifications, those belong in `## Why`.
- Link public GitHub issues inline within `## Why` (e.g. "users reported X (#478)"), not as a trailing `Fixes #N`.
- Do not paste CI, lint, or tool output in the body.
- Do not hard-wrap paragraphs. GitHub renders each newline inside a paragraph as a visible line break, so a 72-column-wrapped paragraph becomes a staircase. Write each paragraph or bullet as one unbroken line; rely on the browser to soft-wrap. Only use newlines to separate paragraphs, list items, or block elements.