publish-pr
Skill3 starsChanged 50 days agoMITView on GitHub
Use in /implement at the draft→ready boundary to squash the branch's review-iteration commits into one (non-interactive soft-reset + recommit + force-with-lease) and mark the draft PR ready. Takes the commit message as input (sourced from the plan-file before cleanup). GitHub-specific (gh) behind a host-neutral contract.
- Deletes or force-pushes
- Commits and pushes
5 other projects use a version of this.
Adopted by
Most recently taken up by
- LeonardiFranco/skillstheir own version, first seen Nov 8, 2026
- tariknz/irdashiestheir own version, first seen Oct 17, 2026
- grove/promise-to-prooftheir own version, first seen Oct 12, 2026
- darknightdesigner/skillstheir own version, first seen Oct 2, 2026
- OpenPerfAgent/who-ate-my-flopstheir own version, first seen Sep 30, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- tariknz/irdashies★ 270same name
- OpenPerfAgent/who-ate-my-flops★ 35same name
- darknightdesigner/skills★ 4same name
- grove/promise-to-proof★ 4same name
- LeonardiFranco/skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- agent-reviewSkill
- capture-to-vaultSkill
- cleanup-artifactsSkill
- dispatch-explorationSkill
- load-contextSkill
- open-draft-prSkill
- plan-fileSkill
- repo-setupSkill
The file
Files
Publish PR
The finalize step of /implement's repo path: collapse the review-iteration commit noise into one clean commit, then mark the draft PR ready for humans. Runs after cleanup-artifacts (so a tracked plan-file deletion folds into the squashed commit).
The squash is a non-interactive local rewrite — git rebase -i isn't available in this harness, and isn't needed.
Input
- branch — the current feature branch (committed; reviewed in its draft PR).
- commit message — the final squashed-commit message. The recipe sources it from the
plan-file(story ref + change summary) beforecleanup-artifactsdeletes that file. - PR ref — the draft PR to mark ready (from
open-draft-pr).
Steps
- Squash the branch to one commit:
Soft-reset to the branch point keeps the branch's work staged;git reset --soft "$(git merge-base origin/main HEAD)" git add -A git commit -m "<commit message>"git add -Athen folds in working-tree changes the index doesn't yet reflect — notablycleanup-artifacts' plan-file deletion, so a tracked plan file isn't re-committed into the squash (thereset --softindex still holds it otherwise). No-op for the gitignored default. One commit then collapses the WIP + review-feedback commits. The goal is eliminating review-iteration noise, not single-commit dogma — squash-to-one is just the simplest mechanism that guarantees no feedback-churn commits survive. If the branch has no changes vs the merge-base, there's nothing to finalize — treat it as a no-op rather than lettinggit commiterror on an empty index. (git add -Aassumes the finalize tree is clean apart fromcleanup-artifacts' deletions; stray untracked scratch/build files would otherwise be swept into the squash.) - Force-push the rewritten branch with an explicit refspec:
git push --force-with-lease origin <branch>(explicit so it doesn't depend on a configured upstream; the lease guards against clobbering an unexpected remote update; safe on a solo feature branch). - Mark the PR ready:
gh pr ready <PR ref>.
Output / contract
- In: (branch, commit message, PR ref).
- Out: a single-commit branch, force-pushed; the PR marked ready for review.
- Side effects: rewrites branch history (force-push); changes PR state draft→ready. No merge — merging stays a human action.
Project overrides
- A repo that prefers GitHub's squash-at-merge over a local pre-ready squash overrides steps 1–2; the contract (clean history at draft→ready) still holds.
Future scope
- Absorb PR creation (post-v1). Under the flow simplification,
open-draft-prgoes away andpublish-prcreates the PR at the end (review having happened on the branch). Don't hard-assume a pre-existing draft beyond thegh pr readystep, so that shift stays cheap.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

