What problem does it solve?
Projects often suffer from inconsistent branch naming, messy commit messages, and ad-hoc PR workflows that slow collaboration and make agent-driven automation brittle. This Skill codifies temporal-plane conventions and provides deterministic scripts to create branches, enforce Conventional Commits, push changes, create or update PRs, check PR status, and clean up merged branches.
Core Features & Use Cases
- Standardized Branching: Enforces the project's ticket-based branch naming pattern and automates branch creation from the default branch.
- Conventional Commits: Guided commit creation that formats messages to Conventional Commits and optionally appends ticket closures.
- Idempotent PR Management: Non-interactive and interactive scripts that create or update PRs via the GitHub CLI, inspect CI checks, and request reviewers.
- Repository Maintenance: Syncing, updating, and cleaning up branches with safe stash/restore behavior to avoid lost work.
- Use Case: An AI agent can generate a feature branch, commit changes with the correct format, push, and create or update a PR reliably using the provided scripts.
Quick Start
Run the new-branch, commit, and create-or-update-pr scripts in sequence to create a correctly named branch, make a Conventional Commit, push the branch, and create or update a pull request.