# pre-pr

pre-pr is a Claude Code skill that checks which tests and docs a Honcho change needs and drafts a PR description with evidence. Run it after the change is complete, before opening a PR.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 131 installs · ★ 8222 repo stars
- Author: plastic-labs
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/plastic-labs/honcho/tree/HEAD/skills/pre-pr/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pre-pr

## What it does

The skill classifies changes using `git diff main...HEAD --stat`, then maps touched project areas to required tests and docs. Changes in `src/` call for matching unit tests; edits to areas such as the queue, configuration, or SDK contract can require additional test layers. Before claiming tests pass, it runs `uv run ruff check src/` and `uv run basedpyright`.

It fills the description and proofs sections of `.github/pull_request_template.md`. It does not open the PR. Changes to `/v3` HTTP or deriver queue behavior trigger `/verify`; skipped layers need a one-line reason. Proofs must reflect commands actually run, so the skill does not treat unverified test results as green.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill pre-pr -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pre-pr/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pre-pr/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill pre-pr -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pre-pr/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill pre-pr -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pre-pr/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install plastic-labs/honcho skills/pre-pr
```

2. **Manually: put the files in place**
- File: `.github/skills/pre-pr/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill pre-pr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/plastic-labs/honcho --path skills/pre-pr
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pre-pr/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill pre-pr -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/plastic-labs/honcho/tree/HEAD/skills/pre-pr/SKILL.md

## When to use it
- identify tests required by the changed project areas
- check whether a public API change needs matching docs
- gather command results and evidence for a PR body
- fill the description and proofs sections of the PR template

## Example prompts
- Check whether my Honcho branch is ready for a PR and fill in the template.
- Draft a PR description for these changes using the checks that actually ran.
- This change touches runtime behavior; prepare the required pre-PR checks.

## Similar
- [pre-merge](https://affpapa.org/en/nevibecode/skills/pre-merge.md) — skill · 346 installs
- [pre-push-gate](https://affpapa.org/en/nevibecode/skills/pre-push-gate.md) — skill · ★ 92149 repo stars
- [pre-commit](https://affpapa.org/en/nevibecode/skills/pre-commit.md) — skill · ★ 149 repo stars
- [om-auto-create-pr-loop](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr-loop.md) — skill · 4700 installs
- [detailed-pr-description](https://affpapa.org/en/nevibecode/skills/detailed-pr-description.md) — skill · 800 installs
- [pre-publish-review](https://affpapa.org/en/nevibecode/skills/morvex885-pre-publish-review.md) — skill · ★ 125 repo stars

From the same set: [plastic-labs/honcho](https://affpapa.org/en/nevibecode/by/plastic-labs/honcho.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
