gh-commit
Commit Changes
Use this skill when the user wants the current local work packaged into a clean commit without taking it through push or GitHub PR creation. Get onto the correct feature branch first when needed, keep commit metadata aligned to the tracked diff, ask before rewriting history on non-default multi-commit branches, and stop after reporting the local commit result.
Boundary Rules
- This skill owns local branch, changeset, and commit preparation only. It does not push or create or update GitHub PRs.
- If the user wants to take the work through push and PR creation, use
gh-pr-createafter this skill prepares or refreshes the commit. - If the user wants a deep critique of the branch approach, implementation plan, or test strategy before mutating git state, use
gh-plan-review.
Core Workflow
- If you are not already on the intended feature branch, create it immediately before doing other work. Do not continue on
main,master, or another default branch. - Name the branch
<username>/<descriptive-name>. Do not usefeature/,feat/, orfix/. Use the system username when it is clear; otherwise fall back to the agent name. - Inspect
git status --short, the current diff, existing repo conventions, and branch history before deciding whether to create a new commit or amend. - Determine whether the current branch is single-commit or multi-commit. Count branch commits relative to the intended PR base when that base is known; otherwise count relative to the repository default-branch merge-base. More than one branch commit is multi-commit.
- Complete the requested work and run the smallest relevant verification for the touched files before committing or amending.
- If the repo uses Changesets, add the smallest accurate changeset before the final commit or amend.
- On a non-default multi-commit branch, do not assume amend or squash. Ask whether to create a new commit, amend
HEAD, or do another explicit history rewrite, and stop until the user answers.
More from beeman/skills
gh-pr-review-comments
Address GitHub pull request review comments on an existing feature branch. Use when Codex needs to fetch live PR review comments with gh, classify each comment as actionable, optional, or rejectable, apply only accepted fixes on the same branch, run a self-review pass for contradictions introduced by those fixes, and then either create a new commit or follow an explicitly approved history-rewrite path before pushing, resolving threads, and re-requesting review.
8feature-structure
Use when reorganizing code around feature boundaries, splitting monolithic screen components or state hooks, deciding whether logic belongs in data-access, feature, ui, or child features, or moving orchestration out of prop-heavy UI files.
8gh-pr-create
Create a GitHub pull request from local repo changes. Use when Codex must get feature-branch setup and local commit packaging from `gh-commit`, get approval before pushing, show the exact PR title and body that will be sent, handle single-commit and multi-commit branch flows explicitly, and open or update the PR with gh.
7gh-issue-kickoff
Kick off work on a GitHub issue with gh. Use when Codex needs to start from the authoritative issue state and local codebase, fix only material issue gaps, and produce the first execution-ready implementation plan. For a deeper critique or tradeoff review of an existing plan, use `gh-plan-review`.
5gh-plan-review
Review, challenge, pressure-test, or refine an implementation plan tied to a GitHub issue, GitHub PR, or active branch. Use when Codex needs to inspect the authoritative GitHub state and local repo context, run a scope challenge, identify material plan risks, surface real tradeoffs, and finish with a fixed review summary without mutating code or git state.
5gh-pr-rebase
Rebase an existing GitHub PR branch onto the repository default branch. Use when Codex needs to fetch the latest default-branch history, keep the local default branch current when that is safe, rebase the current feature branch, resolve straightforward conflicts carefully, ask the user to decide ambiguous conflicts, and update the remote PR branch with `git push --force-with-lease` after any required approval.
5