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.
How this skill is triggered — by the user, by Claude, or both
Slash command
/git-workflow:bl-recordThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Category:** Git Workflow
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.
npx claudepluginhub jpoutrin/product-forge --plugin git-workflowProvides 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 messages from working tree changes, following repo conventions or conventional commits. Handles clean trees and detached HEAD.