tmsjngx0/conventional-commits
skills/conventional-commits/SKILL.md
Reference for Conventional Commits 1.0.0 format. Auto-loads when user asks "how to write commits", "commit message format", "what is conventional commits", "commit best practices".
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add tmsjngx0/mindcontext-core conventional-commitsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 1:27 AM8.8s1 file scanned
SKILL.md
- name:
- conventional-commits
- description:
- Reference for Conventional Commits 1.0.0 format. Auto-loads when user asks "how to write commits", "commit message format", "what is conventional commits", "commit best practices".
Conventional Commits
Reference for writing commit messages following Conventional Commits 1.0.0.
Format
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
Types
| Type | When to Use |
|------|-------------|
| feat | New feature for the user |
| fix | Bug fix for the user |
| docs | Documentation only changes |
| style | Formatting, missing semicolons (no code change) |
| refactor | Code change that neither fixes bug nor adds feature |
| perf | Performance improvement |
| test | Adding or correcting tests |
| build | Build system or external dependencies |
| ci | CI configuration files and scripts |
| chore | Other changes that don't modify src or test files |
| revert | Reverts a previous commit |
Examples
Simple feature:
feat: add user authentication
With scope:
feat(auth): add JWT token validation
With body:
fix(api): handle null response from payment gateway
The payment gateway occasionally returns null instead of
an error object. This caused unhandled exceptions.
Closes #123
Breaking change:
feat(api)!: change authentication to OAuth2
BREAKING CHANGE: API now requires OAuth2 tokens instead of API keys.
All existing API keys will be invalidated on March 1st.
Breaking Changes
Two ways to indicate:
-
Exclamation mark after type/scope:
feat(api)!: remove deprecated endpoints -
Footer:
feat: update authentication BREAKING CHANGE: passwords now require 12 characters minimum
Scope
Optional context in parentheses:
feat(auth):- authentication modulefix(ui):- user interfacedocs(api):- API documentationrefactor(db):- database layer
Best Practices
- Imperative mood - "add" not "added" or "adds"
- Lowercase - start with lowercase
- No period - don't end with a period
- 50 char limit - for the subject line
- Why not what - body explains motivation, not implementation
Quick Reference
feat: New feature
fix: Bug fix
docs: Documentation
style: Formatting
refactor: Code restructuring
perf: Performance
test: Tests
build: Build system
ci: CI/CD
chore: Maintenance
revert: Revert commit
Semantic Versioning
Conventional Commits maps to SemVer:
| Commit Type | Version Bump |
|-------------|--------------|
| fix: | PATCH (0.0.X) |
| feat: | MINOR (0.X.0) |
| BREAKING CHANGE | MAJOR (X.0.0) |
Related Skills
tmsjngx0/mctx-init
tools
VerifiedTrustedCommunity
Bootstrap a project to use mctx by injecting a managed block into AGENTS.md. Tool-agnostic guidance every agent reads. Runs `mctx init` and shows the diff. Use when starting a new project, onboarding a repo, or asked to "init mctx" / "add mctx guidance" / "set up AGENTS.md".
SKILL.mdUpdated Apr 17, 2026
tmsjngx0/tdd
development
VerifiedTrustedCommunity
Test-Driven Development workflow following Kent Beck's methodology. Auto-loads when user asks about "tdd", "test driven", "red green refactor", "write tests first".
SKILL.mdUpdated Apr 16, 2026
tmsjngx0/session-handoff
testing
VerifiedTrustedCommunity
Analyze current session and generate a self-contained context prompt for the next Claude session. Includes project context, decisions, next steps, and tech stack. Use when ending a work session.
SKILL.mdUpdated Apr 16, 2026
tmsjngx0/session-catchup
tools
VerifiedTrustedCommunity
Summarize current project state after a long break. Analyzes recent git history, beads issues, and memory to produce a one-page orientation. Use when returning to a project cold, or when asking "what was I doing", "where did I leave off".
SKILL.mdUpdated Apr 16, 2026