Commit Message Skill
Generates and improves commit messages following conventional commits format.
Conventional Commits Format
<type>(<scope>): <description>
[optional body]
[optional footer]
Types
| Type | Use For |
|---|---|
feat |
New feature |
fix |
Bug fix |
docs |
Documentation only |
style |
Formatting, no code change |
refactor |
Code change that neither fixes a bug nor adds feature |
perf |
Performance improvement |
test |
Adding or updating tests |
chore |
Maintenance tasks |
ci |
CI/CD changes |
build |
Build system changes |
Scopes for This Project
| Scope | Description |
|---|---|
| bits | BitVec, rank/select, popcount |
| bp | Balanced parentheses |
| json | JSON semi-indexing |
| jq | jq query language |
| simd | SIMD implementations |
| cli | CLI tool |
| bench | Benchmarks |
| docs | Documentation |
Examples
Feature Addition
feat(json): add PFSM table-driven parser
Implements parallel finite state machine approach from hw-json-simd.
Achieves 880 MiB/s throughput on x86_64 (AMD Zen 4), 40-77% faster than scalar.
Bug Fix
fix(bp): correct find_close for edge case at word boundary
Fixes #42
Performance Improvement
perf(popcount): add AVX-512 VPOPCNTDQ implementation
5.2x faster than scalar for large bitvectors.
Requires Intel Ice Lake+ or AMD Zen 4+.
Refactoring
refactor(jq): replace deprecated last() with next_back()
Removes dead code and simplifies iterator handling.
Instructions
- Read the staged changes with
git diff --cached - Understand what changed and why
- Choose appropriate type and scope
- Write a concise subject line (50 chars ideal, 72 max)
- Add body if changes need explanation
- Include footer for breaking changes or issue references
Commit Message Rules
- Subject line: Imperative mood ("add" not "added")
- No period at end of subject line
- Blank line between subject and body
- Body: Explain what and why, not how
- Footer: Reference issues, note breaking changes
Converted and distributed by TomeVault — claim your Tome and manage your conversions.