From git-workflow
Records staged/unstaged changes as a new commit using git-branchless in detached HEAD state. Optionally creates a branch for PR submission.
npx claudepluginhub jpoutrin/product-forge --plugin git-workflowThis skill uses the workspace's default tool permissions.
**Category:** Git Workflow
Provides Git-branchless stacked diffs workflow patterns, command references for detached HEAD, smartlog, committing, editing, restacking, syncing, and PR submission.
Commits changes with a short imperative git message following strict style rules; creates new branch if on main. Uses git status, diff, log for context.
Creates git commits with clear, value-communicating messages from staged or unstaged changes, following repo conventions or conventional commit format. Use when user says 'commit' or 'save changes'.
Share bugs, ideas, or general feedback.
Category: Git Workflow
Record staged/unstaged changes as a new commit using git-branchless. Optionally create a branch for the commit.
/bl-record [-m <message>] [--create-branch]
| Option | Description |
|---|---|
-m <message> | Commit message (required) |
--create-branch | Create a branch for PR submission (uses -c flag) |
# Record with message
/bl-record -m "feat: add user validation"
# Record and create branch for PR
/bl-record -m "fix: handle null input" --create-branch
Check Prerequisites
Stage Changes (if needed)
git status to check for changesgit add -A to stage allRecord the Commit
--create-branch is provided:
git branchless record -c -m "<message>"
Then immediately return to detached HEAD:
git checkout --detach
git branchless record -m "<message>"
Show Result
git sl to display the updated stackUser: /bl-record -m "feat: add user model"
Agent: Recording changes...
Staged changes:
A src/models/user.py
M src/models/__init__.py
Running: git branchless record -m "feat: add user model"
◆ abc1234 (main) initial commit
┃
● def5678 feat: add user model ← New commit
Commit recorded successfully.
User: /bl-record -m "fix: validate email" --create-branch
Agent: Recording changes with branch creation...
Staged changes:
M src/validators.py
Running: git branchless record -c -m "fix: validate email"
Branch created: fix-validate-email
Returning to detached HEAD...
Running: git checkout --detach
◆ abc1234 (main) initial commit
┃
● ghi9012 fix: validate email (fix-validate-email) ← New commit with branch
Commit recorded with branch for PR submission.
Use /bl-submit to push the branch.
| Error | Resolution |
|---|---|
| No changes to record | Inform user there's nothing to commit |
| Not in detached HEAD | Warn and suggest git checkout --detach |
| git-branchless not installed | Provide installation command |
| Repo not initialized | Suggest /bl-init |
When using -c to create a branch, git-branchless checks out that branch. We immediately detach again to maintain the branchless workflow where you work in detached HEAD and only create branches when submitting PRs.