Forked from khtsly/skills
Project Files
samples / git-commit / SKILL.md
Use this skill when writing git commit messages, PR descriptions, changelogs, or release notes.
Always use Conventional Commits:
<type>(<scope>): <subject> <body - optional> <footer - optional>
| Type | When to use |
|---|---|
feat | New feature visible to users |
fix | Bug fix |
refactor | Code change that neither fixes a bug nor adds a feature |
perf | Performance improvement |
test | Adding or fixing tests |
docs | Documentation only |
chore | Build, tooling, dependency updates |
ci | CI/CD pipeline changes |
revert | Reverting a previous commit |
BREAKING CHANGE: <description> for breaking API changesCloses #123, Fixes #456 for issue referencesCo-authored-by: Name <email> for pair workSimple fix:
Feature with body:
Breaking change:
Group under the version heading: ## [1.4.0] - 2025-04-01
fix(auth): prevent token refresh loop on 401 response
feat(api): add pagination to /users endpoint
Previously the endpoint returned all users in a single response,
which caused timeouts for accounts with > 10k users.
Adds cursor-based pagination with a default page size of 50.
Existing clients are unaffected - the endpoint returns all results
when no cursor param is provided.
Closes #892
refactor(config): rename DATABASE_URL to DB_CONNECTION_STRING
BREAKING CHANGE: The DATABASE_URL environment variable is no longer
read. Rename it to DB_CONNECTION_STRING in all deployment configs.
## What
One paragraph: what this PR does and why.
## How
Brief explanation of the approach taken. Link to relevant docs or
prior art if the approach is non-obvious.
## Testing
How you verified it works. "Tested manually" is acceptable for small
changes; describe the steps.
## Screenshots (if UI change)
Before / after where helpful.
## Checklist
- [ ] Tests added or updated
- [ ] Docs updated (if public API changed)
- [ ] No unrelated changes included
### Added
- New feature description (#PR or commit hash)
### Changed
- What changed and how it affects users
### Fixed
- Bug description (what it was, what it is now)
### Removed
- What was removed and migration path if needed
### Breaking
- Description + migration instructions