# Commit

> Create a well-structured commit with conventional format and proper git identity

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

---


Create a well-structured commit.

Read git identity from the project's or org's CLAUDE.md `## Automation config` table (`bot_account`, `bot_email`, `owner_account`, `owner_email`).

## Arguments

- `--as-me`: Commit as the owner instead of the bot account
- `--bot-only`: Commit as the bot account without co-author

## Git Identity

| Mode | Git Author | Co-author |
|------|------------|-----------|
| (default) | bot account (bot_email) | owner (owner_email) |
| `--as-me` | owner (owner_email) | none |
| `--bot-only` | bot account (bot_email) | none |

## Process

1. **Set git identity** based on arguments:
   - Default or `--bot-only`: `git config user.name "<bot_account>"` and `git config user.email "<bot_email>"`
   - `--as-me`: `git config user.name "<owner_account>"` and `git config user.email "<owner_email>"`

2. **Review and commit changes:**
   - Review staged and unstaged changes
   - Determine commit type (feat, fix, docs, style, refactor, perf, test, build, ci, chore)
   - Stage relevant files (exclude temp/generated: *.html, *.pdf, build/, *.log, .DS_Store)
   - Write concise commit message in conventional format: `type(scope): description`
   - Never push directly to main

3. **Add co-author trailer** (default mode only):
   - Append `Co-authored-by: <owner_account> <<owner_email>>` to commit message

## Auto-Exit When Standalone
**IMPORTANT**: If this command is being run as a standalone request, automatically exit after completing all phases successfully.