Yeet PR

Use this skill to publish a local branch without bypassing project standards. It wraps staging, committing, pushing, and opening a draft PR around the repository's own write-commit-message and create-pr-description skills.

Required Standards

Before drafting a commit or PR body, read and follow these skills from the target repository when present:

• .agents/skills/write-commit-message/SKILL.md
• .agents/skills/create-pr-description/SKILL.md

If either skill is missing, stop and say which standard is unavailable instead of falling back to generic wording.

Workflow

1. Confirm the target repo and scope
   • Run git status -sb.
   • Inspect changed filenames and enough diff to classify the work.
   • If the worktree contains unrelated changes, do not stage everything. Ask which files belong in the PR.
   • If there are existing staged changes, inspect git diff --cached --name-only and treat them as user-owned until proven in scope.
2. Establish the branch and base
   • Determine the current branch with git branch --show-current.
   • If on main, master, or the remote default branch, create a feature branch before committing.
   • Fetch the target base branch when possible.
   • If the branch is behind the base, prefer rebasing or merging before opening the PR. If conflicts occur, resolve them, rerun relevant checks, and mention the conflict resolution.
3. Use the commit-message standard
   • Follow .agents/skills/write-commit-message/SKILL.md exactly.
   • Infer issue IDs from the branch name first, then from explicit task context.
   • Use the resulting title as the commit subject.
   • Do not invent issue IDs. If none are discoverable, stop and ask for the intended issue or confirm an issue-less commit.
4. Stage and commit intentionally
   • Stage only in-scope files, preferably by explicit path.
   • Use git add -A only when the whole worktree is confirmed in scope.
   • Commit with the standards-compliant subject.
   • Do not amend or rewrite user commits unless the user explicitly asks.
5. Verify after the final history shape
   • If checks already ran before a rebase/merge, rerun at least focused checks after the rebase/merge.
   • Prefer the repo's documented gate when feasible. For Incan, use make pre-commit unless the user asked for a narrower publish.
   • If an acceptance contract was defined by start-work, create-plan, ralph-loop, an issue, or an RFC, verify and record which items were covered, skipped as not applicable, or still residual. Do not discover a new contract at publish time; report whether the earlier contract was honored.
   • If a check fails from sandbox or credential limitations, rerun with the required approval path or report the blocker clearly.
6. Use the PR-description standard
   • Follow .agents/skills/create-pr-description/SKILL.md exactly.
   • Locate the repository PR template.
   • Use the final diff against the chosen base branch and the final commit log.
   • Include RFC lifecycle handling when the diff touches RFC files.
   • Preserve the template checkboxes and closing issue references required by the skill.
7. Choose the GitHub path
   • Prefer local git for branch/commit/push operations.
   • Prefer the GitHub app/connector for PR creation, PR metadata, comments, labels, reviewers, and other GitHub API operations.
   • Do not make gh the default PR-creation path. In Codex sandboxed environments, the user's GitHub token is often not exposed to gh, so gh auth status can fail even when the GitHub connector is available and authenticated.
   • If gh auth status fails with an invalid/missing token inside the sandbox, treat that as a tooling limitation. Use the GitHub connector where possible instead of asking the user to re-authenticate.
   • Use gh only for local git-adjacent information that the connector cannot provide, or as a fallback after confirming gh auth status is valid in the current execution context.
8. Push
   • Push the current branch with tracking: git push -u origin <branch>.
   • If push fails because the remote branch moved, fetch and resolve rather than force-pushing by default.
   • Force-push only when the branch is task-owned and the user explicitly approved rewriting it.
9. Set the PR review state from the work, not a publication default
   • Open the PR ready for review when the accepted scope is complete, the relevant verification has passed, and no unresolved review blockers remain. This is the default for a completed yeet-pr task.
   • Use a draft only when the work is partial or incomplete, a residual blocker needs resolution before useful review, or the user explicitly asks to keep it draft.
   • Do not treat green CI as a prerequisite for review readiness. CI contributes merge evidence; scope completion, targeted tests, docs, and review findings determine whether the change is useful for human review.
   • State the chosen review state and the evidence for it in the final report.
10. Open the PR at the determined state

• Prefer the GitHub app/connector for PR creation once the branch is pushed.
• Derive repository_full_name from origin and head_branch from the current branch.
• Use the remote default branch as base_branch unless the user specified another target.
• Use the standards-compliant PR title and body from the prior steps.
• Create a ready-for-review PR when step 9 finds the work review-ready. Add --draft only when step 9 requires it.
• If the connector cannot create the PR, use gh pr create with --draft only when step 9 requires it and gh auth status is valid in the current execution context; otherwise stop and report that PR creation is blocked by CLI auth while preserving the pushed branch.

Safety Rules

• Never publish unrelated local changes silently.
• Never skip write-commit-message or create-pr-description because another GitHub skill has its own simpler wording.
• Never open a PR with a generic autogenerated body when the repo template exists.
• Never mark a complete, review-ready change as draft merely because CI is pending or because draft feels safer. Draft status must communicate incomplete or intentionally withheld work.
• Never ask the user to run gh auth login merely because sandboxed gh cannot see a token when the GitHub connector can perform the needed GitHub operation.
• Never leave a command running after reporting completion.
• Report any dirty leftovers outside the committed PR scope.

Final Report

End with:

• Branch name
• Commit SHA and subject
• PR URL
• PR review state and its rationale
• Base branch
• Verification commands and results
• Acceptance contract coverage when one exists
• Any residual risks, dirty files, or auth/tooling fallbacks