# Commit

> Create git commits with good messages. Use when user says "commit", "create commit", or asks to commit changes.

- Skill: `openonion/commit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openonion/commit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openonion/commit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: openonion (https://skillmd.com/u/openonion)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openonion/commit

---


# Git Commit Skill

Create a well-formatted git commit for staged changes.

## Instructions

1. **Gather information** (run in parallel):
   - `git status` - See what's staged and unstaged
   - `git diff --staged` - See exactly what will be committed
   - `git log --oneline -5` - See recent commit message style

2. **Analyze changes**:
   - What was changed? (files, functions, features)
   - Why was it changed? (bug fix, new feature, refactor)
   - Follow the repository's commit message style

3. **Draft commit message**:
   - First line: concise summary under 50 chars
   - Focus on "why" not "what"
   - Match existing commit style

4. **Execute commit**:
   - Stage relevant files if needed: `git add <files>`
   - Commit with a normal non-interactive `git commit -m` command
   - Verify with `git status`

The skill supplies procedure, not permission. Git writes and commits must pass
the agent's normal approval policy.

## Safety Rules

- Do NOT commit .env or credential files
- Do NOT use `--amend` unless explicitly asked
- Do NOT push unless explicitly asked
- If commit fails, create a NEW commit (don't amend)

## Example

```bash
git status
git diff --staged
git commit -m "Fix authentication timeout"
git status
```