mcpbeat

Vouch Propose From Pr

vouchdev/vouch-propose-from-pr

Distill a merged PR into vouch claim proposals

250 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
120
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/vouchdev/vouch --skill vouch-propose-from-pr

The instruction itself

1 sections, as written by the author

/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:

  • Parse $ARGUMENTS as a PR URL or <owner>/<repo>#<num>; default to the

most-recently-merged PR you authored.

  • Fetch the PR title, body, and the merged-commit SHA via gh.
  • Register the merge commit as a kb_register_source so subsequent claims

can cite it.

  • 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.

  • 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.

How to use it

Copy the folder

Take vouchdev/vouch-propose-from-pr from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.