Commit Skill – Conventional Commits

When to use

• When user requests “commit this”, “commit”, “save changes”
• When /commit command is invoked

Configuration

Project-specific settings: .agent/skills/commit/config/commit-config.yaml

Commit Types

Commit Format

<type>(<scope>): <description>

[optional body]

Co-Authored-By: First Fluke <our.first.fluke@gmail.com>

Workflow

Step 1: Analyze Changes

git status
git diff --staged
git log --oneline -5

Step 1.5: Split by Feature (if needed)

If changed files span multiple features/domains, split commits by feature.

Split criteria:

• Different scopes (e.g., workflows vs skills vs docs)
• Different types (e.g., feat vs fix vs docs)
• Logically independent changes

Example:

# Changed files:
.agent/workflows/*.md (7 files)     → fix(workflows): ...
.agent/skills/**/*.md (4 files)     → fix(skills): ...
USAGE.md, USAGE-ko.md               → docs: ...

# Split into 3 commits

Do NOT split when:

• All changes belong to a single feature
• Few files changed (5 or fewer)
• User requested a single commit

Step 2: Determine Commit Type

Analyze changes → Select appropriate type:

• New files added → feat
• Bug fixed → fix
• Refactoring → refactor
• Documentation only → docs
• Tests added → test
• Build/config changes → chore

Step 3: Determine Scope

Use changed module/component as scope:

• feat(auth): Authentication related
• fix(api): API related
• refactor(ui): UI related
• No scope is also valid: chore: update dependencies

Step 4: Write Description

• Under 72 characters
• Use imperative mood (add, fix, update, remove…)
• Lowercase first letter
• No trailing period

Step 5: Confirm with User

📝 Commit message preview:

feat(orchestrator): add multi-CLI agent mapping support

- Add user-preferences.yaml for CLI configuration
- Update spawn-agent.sh to read agent-CLI mapping
- Update memory schema with CLI field

Co-Authored-By: First Fluke <our.first.fluke@gmail.com>

Proceed with this commit? (Y/N/Edit)

Step 6: Execute Commit

After user confirmation:

git add <specific-files>
git commit -m "<message>"

References

• Configuration: config/commit-config.yaml
• Guide: resources/conventional-commits.md

Important Notes

• NEVER commit without user confirmation
• NEVER use git add -A or git add . without explicit permission
• NEVER commit files that may contain secrets (.env, credentials, etc.)
• ALWAYS use specific file names when staging
• ALWAYS use HEREDOC for multi-line commit messages