commit-changes
Create clear, informative, and well-structured Git commit messages following best practices and conventional commit standards.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Commit Changes
Instructions
-
Analyze Changes: Run
git diff --staged,git diff, andgit status -
Stage All: Use
git add -Aif needed - Understand Context: What changed, why, type, scope, patterns
- Check Branch: If on main/master, create descriptive branch first
- Generate Message: Subject ≤72 chars, imperative, conventional type
-
Execute:
git commit -m "<message>"
Commit Message Format
<type>(<scope>): <subject>
<body>
Types
| Type | Use Case |
|---|---|
feat |
New feature |
fix |
Bug fix |
docs |
Documentation only |
style |
Formatting, no code change |
refactor |
Code restructuring |
test |
Adding/fixing tests |
chore |
Build, config, dependencies |
Rules
- Imperative mood ("Add feature" not "Added feature")
- No trailing period
- Subject ≤72 characters
- Body explains what/why, not how
- No co-author credits or "Generated with..." tags
Quality Standards
- Meaningful to someone reading git log months later
- Avoid generic: "fix bug", "update code"
- Group related changes conceptually
- Flag if changes too diverse for single message
Edge Cases
| Situation | Action |
|---|---|
| No changes | Inform user nothing to commit |
| Incomplete changes | Flag observation to user |
| On main/master | Create feature branch first |
| Too diverse | Note to user, suggest splitting |
Examples
Example 1: Feature Commit
feat(auth): add JWT token refresh mechanism
- Implement automatic token refresh before expiration
- Add refresh token storage in secure cookie
- Include retry logic for failed refresh attempts
Example 2: Bug Fix Commit
fix(api): prevent null pointer on empty response
Handle case where API returns empty body instead of
throwing unhandled exception in response parser.
Example 3: Refactor Commit
refactor(streamer): extract common mock to shared helper
- Move mockGRPCStreamClient to mock_query.go
- Consolidate 4 duplicate mock implementations
- Reduce test file coupling
Example 4: Multi-scope Commit
test(streamer): consolidate redundant tests
- Remove TestRemoteStream_Success (duplicate of Recv_EventDelivery)
- Merge Close_Idempotent into TestRemoteStream_Close
- Delete tests with no real assertions
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!