new-branch-pr
Installation
SKILL.md
new-branch-pr
Turn the pending changes into a reviewable PR against dev.
- Pre-flight — run the repo's cheap checks (lint, validators, fast tests — whatever exists); confirm
git statusshows only the expected changes. Abort and report if checks fail or something unexpected is dirty. - Audit (only when
--auditis passed; default off) — review every pending implementation for reliably clean code and current best practices: idiomatic and consistent with the surrounding codebase, current APIs and patterns verified against up-to-date docs or skills rather than memory, no dead code, leftover scaffolding, or drive-by complexity. Fix what the audit finds, then re-run pre-flight before continuing. - Ensure
devexists — if the repo has nodevbranch, create it from the current default branch and push it. Then ask the user whether to makedevthe repository default (gh repo edit --default-branch dev); change it only on their confirmation — never unprompted. - Branch — create a descriptive feature branch off
dev(feat/<topic>,fix/<topic>, ...). If the changes build on an unmerged PR that touches the same files, stack on that branch instead and say so. - Commit by conceptual group — one conventional commit (
feat:,fix:,docs:,chore:, ...) per concept, not per file. Keep coupled changes atomic (a change and the registration/config it requires land together). Bodies explain why, not what. - Open the PR — push with
-u, thengh pr create --base devwith a summary of what and why per commit group. Report the PR URL and leave the working tree clean.