- Create commit_message skill with Gitmoji validation and templates - Update bdd_testing skill to match validated BDD implementation - Add comprehensive documentation and validation scripts - Ensure all skills follow AGENTS.md conventions Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
5.1 KiB
5.1 KiB
name, description, license, metadata
| name | description | license | metadata | ||||||
|---|---|---|---|---|---|---|---|---|---|
| commit_message | Helps create proper Gitmoji commit messages following the Common Gitmoji Reference from AGENTS.md. Use when creating commits to ensure consistent, visual commit messages. | MIT |
|
Commit Message Skill
This skill helps create proper Gitmoji commit messages following the Common Gitmoji Reference from AGENTS.md.
Gitmoji Reference
Feature Changes
- ✨
:sparkles:feat: New feature - 🐛
:bug:fix: Bug fix - ♻️
:recycle:refactor: Code refactoring - 🔥
:fire:remove: Remove code/files - 🚀
:rocket:perf: Performance improvements - 🔒
:lock:security: Security fixes
Documentation & Style
- 📝
:memo:docs: Documentation - 🎨
:art:style: Code formatting - 📦
:package:dependencies: Dependency changes
Platform-Specific
- 🐧
:penguin:linux: Linux-specific changes - 🍎
:apple:macos: macOS-specific changes - 🪟
:window:windows: Windows-specific changes
Testing & CI
- 🧪
:test_tube:test: Tests - 🤖
:robot:ci: CI/CD changes
Other
- 📈
:chart_with_upwards_trend:analytics: Analytics/SEO - 🌐
:globe_with_meridians:i18n: Internationalization - ⚡
:zap:performance: Performance improvements - 🔧
:wrench:chore: Build/config changes
Usage Examples
New Feature
git commit -m "✨ feat: add user authentication"
git commit -m "✨ feat: implement BDD testing framework"
Bug Fix
git commit -m "🐛 fix: resolve port conflict in test server"
git commit -m "🐛 fix: handle JSON escaping in feature files"
Documentation
git commit -m "📝 docs: add comprehensive BDD testing guide"
git commit -m "📝 docs: update AGENTS.md with commit conventions"
Refactoring
git commit -m "♻️ refactor: move log setup to config package"
git commit -m "♻️ refactor: improve step pattern matching"
Tests
git commit -m "🧪 test: add BDD scenarios for greet service"
git commit -m "🧪 test: implement health endpoint validation"
Configuration
git commit -m "🔧 chore: add log output file configuration"
git commit -m "🔧 chore: update build system scripts"
Best Practices
Commit Message Structure
<gitmoji> <type>: <description>
<optional body with details>
<optional footer with references>
Examples
Simple commit:
✨ feat: add skill_creator framework
Detailed commit:
✨ feat: implement BDD testing with Godog
- Add features/greet.feature and features/health.feature
- Implement step definitions in pkg/bdd/steps/
- Create hybrid in-process test server
- Add comprehensive documentation
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Complex commit:
🧪 test: add comprehensive BDD test suite
- Implement greet service scenarios
- Add health endpoint validation
- Create test server on port 9191
- Ensure no undefined/pending steps
Resolves: #42
Ref: AGENTS.md
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Validation
Check Commit Message Format
# Verify gitmoji is present
echo "$commit_message" | grep -E "^[[:space:]]*[🎨✨🐛📝🔧♻️🚀🔒📦🔥🐧🍎🪟🤖🧪📈🌐⚡]"
# Verify type: description format
echo "$commit_message" | grep -E "^[🎨✨🐛📝🔧♻️🚀🔒📦🔥🐧🍎🪟🤖🧪📈🌐⚡][[:space:]]+[a-z_]+:"
Common Validation Issues
| Issue | Cause | Solution |
|---|---|---|
| Missing gitmoji | No emoji at start | Add appropriate gitmoji from reference |
| Wrong type | Type doesn't match emoji | Use correct type from reference table |
| Missing colon | No colon after type | Add colon: feat: not feat |
| Long first line | First line > 50 chars | Keep first line concise, add details in body |
References
Troubleshooting
Finding the Right Gitmoji
# Search for appropriate gitmoji
grep "feature\|new" .vibe/skills/commit_message/SKILL.md
# Result: ✨ :sparkles: feat - New feature
Commit Message Too Long
# Split into concise first line + detailed body
git commit -m "✨ feat: add BDD framework" -m "- Implement Godog testing" -m "- Add greet/health features" -m "- Create test server"
Multiple Changes in One Commit
# Use comprehensive description
git commit -m "♻️ refactor: improve BDD implementation" -m "- Update step patterns to match Godog exactly" -m "- Add JSON response validation" -m "- Implement server verification" -m "- Update all templates and documentation"
Assets
- gitmoji-cheatsheet.md: Quick reference for common gitmoji
- commit-template.txt: Git commit message template
- validate-commit.sh: Commit message validation script