create-commit

name	create-commit
description	Stage files and create one or more commits in a single pass
user-invocable	false
model	haiku
allowed-tools	Bash

create-commit

Model-invocable skill for creating commits. The grouping and the messages are decided before this skill runs (by analyze-changes); this skill only executes that plan. git is the tool and it is already known — so run it directly, in one pass. Do not reason between commits, do not re-decide grouping, do not invoke a sub-agent per commit.

Purpose

Stage the decided files and create the decided commits. Pure execution, no decision-making. When handed several groups, commit all of them in this one invocation — never one call per group.

Input

Receive from the caller a commit plan — one or more groups, each:

• files: list of files to stage for this group
• type: conventional type (feat, fix, refactor, docs, chore, …)
• scope: component/area
• subject: imperative, present tense
• body: optional description
• issue: optional issue number

The plan may arrive inline or as a path to the analysis/groups file (e.g. analysis.yaml); read the file if a path is given. Either way, treat it as the final plan — execute, don't revise.

Process

Loop over the groups in order, in this single invocation. For each group, run the two git commands directly — no thinking step in between:

1. Stage that group's files (only the files listed — never git add . / -A)

   git add "file1" "file2" "file3"
   

2. Commit with the conventional message

   git commit -m "type(scope): subject
   
   body
   
   Issue: #123"
   

3. Record the hash

   git rev-parse --short HEAD
   

After the last group, confirm the tree is clean (git status --porcelain). Do not push — pushing is the caller's separate step.

Output

Return using template: templates/commit-output.md — one entry per commit (hash + message), and the final clean-tree confirmation.

Constraints

• ONLY stage files explicitly listed for each group.
• NEVER use git add . or git add -A.
• ALWAYS use conventional commit format.
• Commit every group in ONE invocation — never a separate call (or sub-agent) per group.
• NEVER push.

Version

Field	Value
Version	2.0.0
Category	operations