| name | commit |
| description | Run pre-commit validation before committing. Use for automated hooks, Terraform cleanup, or emoji reference. For simple commits, Claude's native capability suffices. |
| disable-model-invocation | true |
| argument-hint | [--no-verify] - skip pre-commit hooks |
| allowed-tools | Read, Bash(git:*), Bash(pre-commit:*), Bash(uv:*), Bash(pip:*), Bash(find:*), Bash(source:*), Bash(SKIP=*:*) |
Commit Skill
Run pre-commit validation and create well-formatted commits with conventional format.
When to Use
- Pre-commit hooks needed
- Terraform files involved (needs cache cleanup)
- Want emoji reference for commit types
For simple commits without hooks: use Claude's native git capability.
Usage
/commit # Run pre-commit, then commit
/commit --no-verify # Skip pre-commit hooks
Project Rule
No Co-Authored-By lines - per CLAUDE.md, never include co-authoring footers.
Workflow
1. Pre-commit Validation (unless --no-verify)
Automatic setup (silent, no user confirmation):
- Clean Terraform temporary files:
find . -type d \( -name ".terraform" -o -name ".terragrunt-cache" \) -exec rm -rf {} + 2>/dev/null
find . -name ".terraform.lock.hcl" -delete 2>/dev/null
- Create virtual environment if needed:
uv venv
- Install pre-commit:
uv pip install pre-commit
- Install hooks:
pre-commit install
Run validation:
pre-commit run --all-files
If checks fail: analyze errors, provide recommendations, stop commit process.
2. Commit Format
<emoji> <type>: <description>
| Type | Emoji | Use Case |
|---|
feat | ✨ | New feature |
fix | 🐛 | Bug fix |
docs | 📝 | Documentation |
refactor | ♻️ | Code restructuring |
perf | ⚡️ | Performance |
test | ✅ | Tests |
chore | 🔧 | Tooling/config |
ci | 🚀 | CI/CD |
security | 🔒️ | Security fixes |
See references/emoji-guide.md for full emoji list.
3. Create Commit
git commit -m "$(cat <<'EOF'
<emoji> <type>: <description>
[Optional body explaining why]
EOF
)"
Pre-commit Failure Fixes
| Category | Fix |
|---|
| Terraform validation | Run terraform init in affected directories |
| Formatting | Re-run pre-commit (auto-fixes many issues) |
| Security issues | Manual review required |
| KCL formatting | Run kcl fmt in module directory |
| YAML/JSON syntax | Manual correction needed |
| Large files | Remove or use Git LFS |
Stop commit process until issues are resolved.
Examples
✨ feat: add user authentication system
🐛 fix: resolve memory leak in rendering process
📝 docs: update API documentation with new endpoints
♻️ refactor: simplify error handling logic in parser
🔒️ fix: strengthen authentication password requirements
🚀 ci: add KCL validation to CI pipeline
🔧 chore: update Helm chart dependencies
