The code and data behind xeiaso.net
feat(skills): add conventional commits skill from tigrisdata/skills (#1159)
Copies the conventional commits skill from
https://github.com/tigrisdata/skills to provide structured commit
message guidance following the Conventional Commits specification.
https://claude.ai/code/session_01W1tGV4E7MPsz1bDmkZmEW7
Co-authored-by: Claude <noreply@anthropic.com>
+195
+195
.claude/skills/conventional-commits/SKILL.md
+195
.claude/skills/conventional-commits/SKILL.md
···
1
+
---
2
+
name: conventional-commits
3
+
description: Use when creating git commits, writing commit messages, or following version control workflows
4
+
---
5
+
6
+
# Conventional Commits
7
+
8
+
Structured commit message format for version control that provides clear, readable project history.
9
+
10
+
## Overview
11
+
12
+
The Conventional Commits specification provides:
13
+
14
+
- **Automated changelog generation** - Tools can parse commits to generate CHANGELOG.md
15
+
- **Semantic versioning** - Commit types map to version bumps (feat → minor, breaking → major)
16
+
- **Clear project history** - Standardized format makes git log readable
17
+
- **Automated releases** - CI/CD can trigger releases based on commit types
18
+
19
+
## Quick Reference
20
+
21
+
| Type | Use For | Version Bump |
22
+
| ---- | ------- | ------------ |
23
+
| `feat` | New feature | MINOR |
24
+
| `fix` | Bug fix | PATCH |
25
+
| `docs` | Documentation only | PATCH |
26
+
| `style` | Formatting, no logic change | PATCH |
27
+
| `refactor` | Code restructuring, no behavior change | PATCH |
28
+
| `perf` | Performance improvement | PATCH |
29
+
| `test` | Adding or updating tests | PATCH |
30
+
| `build` | Build system or dependencies | PATCH |
31
+
| `ci` | CI/CD configuration | PATCH |
32
+
| `chore` | Maintenance, no user-facing change | PATCH |
33
+
| `revert` | Revert a previous commit | PATCH |
34
+
35
+
## Format
36
+
37
+
```text
38
+
<type>[optional scope]: <description>
39
+
40
+
[optional body]
41
+
42
+
[optional footer(s)]
43
+
```
44
+
45
+
**Rules:**
46
+
47
+
- Type is required
48
+
- Scope is optional - use parenthesized section affected: `(api)`, `auth)`, `parser)`
49
+
- Description is required
50
+
- Keep description concise, imperative mood, lowercase, no trailing period
51
+
- Body and footer are optional
52
+
- Separate subject from body with blank line
53
+
- Wrap body at 72 characters
54
+
55
+
## Examples
56
+
57
+
```text
58
+
feat: add user authentication
59
+
60
+
Implement JWT-based authentication with login/logout endpoints.
61
+
Includes password hashing and session management.
62
+
63
+
Closes: #123
64
+
```
65
+
66
+
```text
67
+
fix(api): handle null response from server
68
+
69
+
Previous implementation crashed when server returned null.
70
+
Now returns empty result set.
71
+
72
+
Assisted-by: GLM 4.6 via Claude Code
73
+
```
74
+
75
+
```text
76
+
feat(storage)!: change bucket listing API
77
+
78
+
BREAKING CHANGE: bucket list now returns async iterator
79
+
instead of array. Update all callers to use for-await.
80
+
```
81
+
82
+
```text
83
+
refactor(core): simplify error handling
84
+
85
+
Consolidate duplicate error handlers into single utility.
86
+
No behavior changes - internal cleanup only.
87
+
```
88
+
89
+
```text
90
+
revert: feat(auth): add OAuth support
91
+
92
+
This reverts commit 8b5a1c2. OAuth provider changed
93
+
their API and we need to redesign integration.
94
+
```
95
+
96
+
## Breaking Changes
97
+
98
+
Indicate breaking changes in two ways:
99
+
100
+
**Option 1**: Add `!` after type/scope
101
+
102
+
```text
103
+
feat(api)!: remove deprecated endpoint
104
+
```
105
+
106
+
**Option 2**: Add `BREAKING CHANGE:` footer
107
+
108
+
```text
109
+
feat(api): remove deprecated endpoint
110
+
111
+
BREAKING CHANGE: endpoint no longer exists. Use newEndpoint instead.
112
+
```
113
+
114
+
## AI Attribution
115
+
116
+
AI agents must disclose their assistance in the commit footer:
117
+
118
+
```text
119
+
Assisted-by: [Model Name] via [Tool Name]
120
+
```
121
+
122
+
Examples:
123
+
124
+
- `Assisted-by: GLM 4.6 via Claude Code`
125
+
- `Assisted-by: Claude Opus 4.5 via claude.ai`
126
+
127
+
## Common Mistakes
128
+
129
+
| Mistake | Why Wrong | Correct |
130
+
| ------- | --------- | ------- |
131
+
| `Added login feature` | Past tense, capitalized | `feat: add login feature` |
132
+
| `fix bug.` | Trailing period | `fix: resolve login error` |
133
+
| `update` | Missing type | `chore: update dependencies` |
134
+
| `feature:add-auth` | Missing space after colon | `feat: add authentication` |
135
+
| `FEAT: big change` | Uppercase type | `feat: add authentication` |
136
+
| Multi-line description no blank line | No separation | Add blank line after subject |
137
+
138
+
## Body Guidelines
139
+
140
+
- **What**: Motivation for the change (vs. code comments describe HOW)
141
+
- **Contrast**: Explain the WHY and WHAT, not code details
142
+
- **Wrap at 72 characters** for readability in git log
143
+
144
+
```text
145
+
feat(summarization): add support for nested bullet points
146
+
147
+
Previous implementation only flattened all content. Now preserves
148
+
hierarchy by respecting indentation levels. Users can now create
149
+
structured summaries with parent-child relationships.
150
+
151
+
Closes: #456
152
+
```
153
+
154
+
## Footer Guidelines
155
+
156
+
Use footers for:
157
+
158
+
- **Breaking changes**: `BREAKING CHANGE: detailed explanation`
159
+
- **Issue references**: `Closes: #123`, `Fixes: #456`, `Refs: #789`
160
+
- **AI attribution**: `Assisted-by: Model via Tool`
161
+
162
+
Multiple footers separated by blank lines:
163
+
164
+
```text
165
+
feat: add batch upload
166
+
167
+
Implements multipart upload for large files.
168
+
169
+
BREAKING CHANGE: upload() signature changed - now requires options object
170
+
Closes: #123
171
+
Assisted-by: GLM 4.6 via Claude Code
172
+
```
173
+
174
+
## Git Commit Flags
175
+
176
+
**Required flag:** Always use `--signoff` when committing:
177
+
178
+
```bash
179
+
git commit --signoff -m "feat: add user authentication"
180
+
```
181
+
182
+
The `--signoff` flag adds a `Signed-off-by` trailer to the commit message, indicating the committer has certified the commit follows developer certificate of origin (DCO).
183
+
184
+
## Testing Your Commit
185
+
186
+
Before committing, verify:
187
+
188
+
1. [ ] Type is from allowed list
189
+
2. [ ] Description is imperative mood (add, fix, update)
190
+
3. [ ] Description is lowercase
191
+
4. [ ] No trailing period on description
192
+
5. [ ] Breaking changes marked with `!` or footer
193
+
6. [ ] AI attribution included (if applicable)
194
+
7. [ ] Body explains WHY not HOW
195
+
8. [ ] Using `--signoff` flag