# Aidd Vcs:01:commit

> Create an atomic git commit with conventional message format. Supports interactive mode (human-driven, may split commits, asks approval) and auto mode (agent-driven, no approval, single commit). Use when the user says "commit", "git commit", "create a commit", "commit my changes", "commit and push", or invokes `/commit`. Do NOT use for amending existing commits, force-pushing, rebasing, opening pull requests, or release tagging.

- Skill: `ai-driven-dev/aidd-vcs-01-commit` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add ai-driven-dev/aidd-vcs-01-commit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai-driven-dev/aidd-vcs-01-commit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ai-driven-dev (https://skillmd.com/u/ai-driven-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ai-driven-dev/aidd-vcs-01-commit

---


# Commit

Generates atomic git commits with standardized conventional messages. Stages files, drafts or accepts an imposed message, runs the commit, optionally pushes, and returns the resulting sha.

## Available actions

| #   | Action   | Role                                                          | Input                                       |
| --- | -------- | ------------------------------------------------------------- | ------------------------------------------- |
| 01  | `commit` | Stage, generate or accept a message, commit, optionally push   | mode, message, push, files                  |

## Default flow

Single action skill. The router dispatches to `commit` whenever a commit phrase or slash command appears.

## Transversal rules

- Commits stay atomic and focused on a single concern.
- Messages use imperative mood ("Add feature" not "Added feature").
- Explain "why" not "what" in the body.
- Never `--force` push. `--force-with-lease` is acceptable when explicitly required.
- Follow the conventional commit format defined in `assets/commit-template.md`.
- Reference issues in the commit body when applicable.
- `auto` mode never asks for confirmation. `interactive` mode requires user approval before staging and before committing splits.

## References

- None.

## Assets

- `assets/commit-template.md`: Conventional commit format reference.

## External data

- None.