Commit Skill

Use this skill when creating git commits. All commits must follow Angular Conventional Commits format because:

•Git hooks enforce it (commit will be rejected otherwise)
•Cocogitto parses commits to generate release changelogs

Commit Message Format

text

<type>(<scope>): <subject>

[optional body]

[optional footer]

Requirements:

•Type: lowercase, from allowed list
•Scope: mandatory, lowercase, describes what changed
•Subject: lowercase start, imperative mood, no period
•Breaking changes: add exclamation mark before colon (e.g. feat(api)!:)

Allowed Types

Angular standard types

Type	Purpose	In Changelog
`feat`	New feature	Yes
`fix`	Bug fix	Yes
`docs`	Documentation only	Yes
`refactor`	Code change (no feat/fix)	Yes
`perf`	Performance improvement	Yes
`build`	Build system changes	Yes
`style`	Formatting, whitespace	No
`test`	Adding/fixing tests	No
`ci`	CI/CD configuration	No

Extended types (not in original Angular spec)

These are widely adopted extensions configured in cog.toml:

Type	Purpose	In Changelog
`chore`	Maintenance, deps, tooling	No
`revert`	Revert previous commit	Yes

Scope Naming Guidelines

Scopes should be consistent to group related changes in changelogs.

Component scopes

•fmt - TOML formatting logic
•cli - command-line interface
•toml - TOML parsing and manipulation

Infrastructure scopes

•version - version bumps
•deps - dependency updates
•ci - CI/CD workflows (use with ci: or chore: type)
•config - configuration files
•msrv - minimum supported Rust version

Documentation scopes

•readme - README.md changes
•claude - CLAUDE.md, Claude Code skills

Testing scopes

•tests - general test changes

Examples

Good commit messages

text

feat(fmt): add support for inline tables
fix(toml): handle empty arrays correctly
docs(readme): update installation instructions
refactor(cli): simplify argument parsing
test(fmt): add tests for table sorting
chore(deps): update toml_edit to 0.22
ci(workflows): add release binary uploads
feat(fmt)!: change default sorting behavior

Bad commit messages

text

feat: add feature              # missing scope
Fix(fmt): Fix bug              # uppercase type and subject
feat(fmt): Add feature.        # uppercase subject, has period
updated the readme             # wrong format entirely
feat(fmt) add feature          # missing colon
feat(Fmt): add feature         # uppercase scope

Breaking Changes

For breaking changes, add an exclamation mark after the scope:

text

feat(fmt)!: change default table ordering

BREAKING CHANGE: Tables are now sorted alphabetically by default.
Use --no-sort to preserve original ordering.

This will appear prominently in the changelog.

Commit Process

•Stage your changes: git add <files>
•Commit with message: git commit -m "type(scope): subject"
•
Hooks automatically run:
- •pre-commit: fmt and clippy checks
- •commit-msg: validates conventional commit format
- •post-commit: verifies signature

If the commit is rejected, fix the issue and try again.

Multi-line Commits

For complex changes, use a body:

bash

git commit -m "feat(fmt): add table sorting options

Adds --sort and --no-sort flags to control table ordering.
Default behavior now sorts tables alphabetically.

Closes #42"

Checking Recent Commits

To see the commit style used in this repo:

bash

git log --oneline -20