# Vouch Propose From Pr

> Distill a merged PR into vouch claim proposals

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

---


# /vouch-propose-from-pr

A PR is a decision: someone proposed a change, the team accepted it. The
"why" gets compressed into the merge message and forgotten. This command
preserves the why as cited claims in the KB.

Steps:

1. Parse `$ARGUMENTS` as a PR URL or `<owner>/<repo>#<num>`; default to the
   most-recently-merged PR you authored.
2. Fetch the PR title, body, and the merged-commit SHA via `gh`.
3. Register the merge commit as a `kb_register_source` so subsequent claims
   can cite it.
4. Read the diff. For each *behavioural* change (not formatting / renaming),
   draft one `kb_propose_claim` whose text summarises the new invariant the
   code now upholds, citing the source from step 3.
5. Propose at most five claims per PR. If a PR is that big, suggest the
   contributor split it next time.

Do not auto-approve. The KB's review gate is intentional; this command
only fills the queue.

