smart github commit pr assistant

The problem

Manually staging files, writing imperative commit messages, and managing stacked pull requests is repetitive and prone to error. Developers often struggle to maintain clean commit history or properly link dependent PRs when working on complex features.

What it does

• Scans repository state, diffs, and PR templates to determine the best workflow.
• Groups working changes into logical, atomic commits with concise, professional messages.
• Automates the creation of normal or stacked pull request chains with correct branch targeting.
• Ensures safety by requiring explicit confirmation for every push and PR creation.
• Detects integration branches and follows repository-specific PR templates.

Frameworks & tools

Git, GitHub CLI (gh), Shell.

Why this beats prompting it yourself

This skill implements a rigorous multi-step inspection and safety protocol that prevents common AI mistakes like git add . or force-pushing. It handles the complex logic of targeting parent branches in stacked PR workflows, which is difficult to coordinate via basic prompting.

Use cases

• Splitting a large set of changes into a chain of dependent, reviewable stacked PRs.
• Converting messy working directory changes into a clean, staged commit history.
• Automating draft PR creation that adheres strictly to a project's PULL_REQUEST_TEMPLATE.md.
• Ensuring consistent, imperative commit style across a team without manual editing.

Known limitations

Requires the GitHub CLI (gh) for PR creation. Cannot automatically resolve merge conflicts or install missing dependencies.