auto-pr
Use when the user invokes `/auto-pr <repo-url>` or asks to "open N PRs against <repo>", "auto-contribute to <repo>", or "raise mergeable PRs automatically". Wraps the `vouch auto-pr` CLI: points at any github repo, learns its contribution norms (from shipped guidance, else synthesized from merged PRs), sources work items (open issues first, then agent-discovered improvements), and drives claude/codex to fix each one — alternating fixer and reviewer — opening a PR only when the repo's own test gate is green and the reviewing engine signs off.
npx skills add vouchdev/vouch --skill auto-pr --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# auto-pr **Goal:** point at any github repo and open N *mergeable* PRs — not N PRs. each one resolves a real issue (or a genuine discovered improvement), passes the repo's own test gate locally, and is signed off by a second engine before it ever reaches a maintainer. this is a thin orchestration layer over the `vouch auto-pr` CLI. it is a sibling tool to the knowledge base: it never writes to storage / proposals / the audit log, and the review gate is untouched. ## invocation ``` vouch auto-pr <repo-url> \ --workspace <dir> --count <N> \ --claude-effort <low|medium|high|max> \ --codex-effort <low|medium|high|max> \ [--issue-label good-first-issue] \ [--fork-owner <login>] \ [--max-revise 2] [--autonomy edit|full] \ [--dry-run] [--json] ``` `<repo-url>` may be `https://github.com/<owner>/<name>`, `git@github.com:<owner>/<name>.git`, or the `<owner>/<name>` shorthand. output: the URLs of the PRs that were actually opened (one per line, or a JSON array under `--json`). attempts that fail verification are reported on stderr as *skipped* with a reason — they are never opened. **M genuine PRs beats N shaky ones**; partial success is the intended behaviour, not an error. ## prerequisite
- invocation
- prerequisites
- how it works (the pipeline)
- house rules it enforces
- effort levels
- autonomy & safety
- failure semantics
What does the auto-pr skill do?
Use when the user invokes `/auto-pr <repo-url>` or asks to "open N PRs against <repo>", "auto-contribute to <repo>", or "raise mergeable PRs automatically". Wraps the `vouch auto-pr` CLI: points at any github repo, learns its contribution norms (from shipped guidance, else synthesized from merged PRs), sources work items (open issues first, then agent-discovered improvements), and drives claude/codex to fix each one — alternating fixer and reviewer — opening a PR only when the repo's own test gate is green and the reviewing engine signs off.
How do I install it?
Run `npx skills add vouchdev/vouch --skill auto-pr --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From vouchdev/vouch, a repository with 120 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.