Conventional Commits
by @bastos
Format commit messages using the Conventional Commits specification. Use when creating commits, writing commit messages, or when the user mentions commits, git commits, or commit messages. Ensures commits follow the standard format for automated tooling, changelog generation, and semantic versioning.
clawhub install conventional-commitsπ About This Skill
name: conventional-commits description: Format commit messages using the Conventional Commits specification. Use when creating commits, writing commit messages, or when the user mentions commits, git commits, or commit messages. Ensures commits follow the standard format for automated tooling, changelog generation, and semantic versioning. license: MIT metadata: author: github.com/bastos version: "2.0"
Conventional Commits
Format all commit messages according to the Conventional Commits specification. This enables automated changelog generation, semantic versioning, and better commit history.
Format Structure
[optional scope]: [optional body]
[optional footer(s)]
Commit Types
Required Types
feat: - A new feature (correlates with MINOR in Semantic Versioning)fix: - A bug fix (correlates with PATCH in Semantic Versioning)Common Additional Types
docs: - Documentation only changesstyle: - Code style changes (formatting, missing semicolons, etc.)refactor: - Code refactoring without bug fixes or new featuresperf: - Performance improvementstest: - Adding or updating testsbuild: - Build system or external dependencies changesci: - CI/CD configuration changeschore: - Other changes that don't modify src or test filesrevert: - Reverts a previous commitScope
An optional scope provides additional contextual information about the section of the codebase:
feat(parser): add ability to parse arrays
fix(auth): resolve token expiration issue
docs(readme): update installation instructions
Description
Body
Breaking Changes
Breaking changes can be indicated in two ways:
1. Using ! in the type/scope
feat!: send an email to the customer when a product is shipped
feat(api)!: send an email to the customer when a product is shipped
2. Using BREAKING CHANGE footer
feat: allow provided config object to extend other configsBREAKING CHANGE: extends key in config file is now used for extending other config files
3. Both methods
chore!: drop support for Node 6BREAKING CHANGE: use JavaScript features not available in Node 6.
Examples
Simple feature
feat: add user authentication
Feature with scope
feat(auth): add OAuth2 support
Bug fix with body
fix: prevent racing of requestsIntroduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.
Remove timeouts which were used to mitigate the racing issue but are
obsolete now.
Breaking change
feat!: migrate to new API clientBREAKING CHANGE: The API client interface has changed. All methods now
return Promises instead of using callbacks.
Documentation update
docs: correct spelling of CHANGELOG
Multi-paragraph body with footers
fix: prevent racing of requestsIntroduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.
Remove timeouts which were used to mitigate the racing issue but are
obsolete now.
Reviewed-by: Z
Refs: #123
Guidelines
1. Always use a type - Every commit must start with a type followed by a colon and space 2. Use imperative mood - Write as if completing the sentence "If applied, this commit will..." 3. Be specific - The description should clearly communicate what changed 4. Keep it focused - One logical change per commit 5. Use scopes when helpful - Scopes help categorize changes within a codebase 6. Document breaking changes - Always indicate breaking changes clearly
Semantic Versioning Correlation
fix: β PATCH version bump (1.0.0 β 1.0.1)feat: β MINOR version bump (1.0.0 β 1.1.0)When to Use
Use this format for:
Common Mistakes to Avoid
β Added new feature (past tense, capitalized)
β
feat: add new feature (imperative, lowercase)
β fix: bug (too vague)
β
fix: resolve null pointer exception in user service
β feat: add feature (redundant)
β
feat: add user profile page
β feat: Added OAuth support. (past tense, period)
β
feat: add OAuth support
β‘ When to Use
π‘ Examples
Simple feature
feat: add user authentication
Feature with scope
feat(auth): add OAuth2 support
Bug fix with body
fix: prevent racing of requestsIntroduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.
Remove timeouts which were used to mitigate the racing issue but are
obsolete now.
Breaking change
feat!: migrate to new API clientBREAKING CHANGE: The API client interface has changed. All methods now
return Promises instead of using callbacks.
Documentation update
docs: correct spelling of CHANGELOG
Multi-paragraph body with footers
fix: prevent racing of requestsIntroduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.
Remove timeouts which were used to mitigate the racing issue but are
obsolete now.
Reviewed-by: Z
Refs: #123