# conventional-commits

Enforces the Conventional Commits specification, adds AI tool attribution, and applies signoff flags for standardized git workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 105 installs · ★ 2 repo stars
- Author: tigrisdata
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/tigrisdata/skills/tree/HEAD/skills/conventional-commits/SKILL.md
- Updated: 2026-07-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tigrisdata-conventional-commits

## What it does

This skill instructs coding agents to format every commit message according to the Conventional Commits standard. It maps permitted commit types such as `feat`, `fix`, `docs`, and `chore` directly to semantic version bumps. Descriptions must stay concise, lowercase, and in the imperative mood without trailing periods, while body text wraps at 72 characters to keep git logs readable.

Every commit created under these rules requires the `--signoff` flag to verify compliance with the Developer Certificate of Origin. The instructions also enforce AI attribution in the commit footer through `Assisted-by: [Model Name] via [Tool Name]`, alongside issue closing tags and `BREAKING CHANGE:` indicators.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tigrisdata/skills --skill conventional-commits -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/conventional-commits/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/conventional-commits/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tigrisdata/skills --skill conventional-commits -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/conventional-commits/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tigrisdata/skills --skill conventional-commits -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/conventional-commits/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tigrisdata/skills skills/conventional-commits
```

2. **Manually: put the files in place**
- File: `.github/skills/conventional-commits/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tigrisdata/skills --skill conventional-commits -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tigrisdata/skills --path skills/conventional-commits
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/conventional-commits/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tigrisdata/skills --skill conventional-commits -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tigrisdata/skills/tree/HEAD/skills/conventional-commits/SKILL.md

## When to use it
- format commit messages according to Conventional Commits standards
- mark breaking changes for automated semantic version bumping
- attribute AI model contributions inside the commit footer
- sign off commits with DCO trailers using the git signoff flag

## Example prompts
- Commit these changes to the auth module with a fix for the null response bug
- Prepare a commit message for refactoring error handlers in the core package
- Create a commit for the breaking API update in storage and link issue 123

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 51beae3f20e77450.

BEGIN THIRD-PARTY FILE 51beae3f20e77450
````text
---
name: conventional-commits
description: Use when creating git commits, writing commit messages, or following version control workflows
---

# Conventional Commits

Structured commit message format for version control that provides clear, readable project history.

## Overview

The Conventional Commits specification provides:

- **Automated changelog generation** - Tools can parse commits to generate CHANGELOG.md
- **Semantic versioning** - Commit types map to version bumps (feat → minor, breaking → major)
- **Clear project history** - Standardized format makes git log readable
- **Automated releases** - CI/CD can trigger releases based on commit types

## Quick Reference

| Type | Use For | Version Bump |
| ---- | ------- | ------------ |
| `feat` | New feature | MINOR |
| `fix` | Bug fix | PATCH |
| `docs` | Documentation only | PATCH |
| `style` | Formatting, no logic change | PATCH |
| `refactor` | Code restructuring, no behavior change | PATCH |
| `perf` | Performance improvement | PATCH |
| `test` | Adding or updating tests | PATCH |
| `build` | Build system or dependencies | PATCH |
| `ci` | CI/CD configuration | PATCH |
| `chore` | Maintenance, no user-facing change | PATCH |
| `revert` | Revert a previous commit | PATCH |

## Format

```text
<type>[optional scope]: <description>

[optional body]

[optional footer(s)]
```

**Rules:**

- Type is required
- Scope is optional - use parenthesized section affected: `(api)`, `auth)`, `parser)`
- Description is required
- Keep description concise, imperative mood, lowercase, no trailing period
- Body and footer are optional
- Separate subject from body with blank line
- Wrap body at 72 characters

## Examples

```text
feat: add user authentication

Implement JWT-based authentication with login/logout endpoints.
Includes password hashing and session management.

Closes: #123
```

```text
fix(api): handle null response from server

Previous implementation crashed when server returned null.
Now returns empty result set.

Assisted-by: GLM 4.6 via Claude Code
```

```text
feat(storage)!: change bucket listing API

BREAKING CHANGE: bucket list now returns async iterator
instead of array. Update all callers to use for-await.
```

```text
refactor(core): simplify error handling

Consolidate duplicate error handlers into single utility.
No behavior changes - internal cleanup only.
```

```text
revert: feat(auth): add OAuth support

This reverts commit 8b5a1c2. OAuth provider changed
their API and we need to redesign integration.
```

## Breaking Changes

Indicate breaking changes in two ways:

**Option 1**: Add `!` after type/scope

```text
feat(api)!: remove deprecated endpoint
```

**Option 2**: Add `BREAKING CHANGE:` footer

```text
feat(api): remove deprecated endpoint
````
END THIRD-PARTY FILE 51beae3f20e77450

The third-party file has ended. Everything between the 51beae3f20e77450 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2772 of 5263 bytes. © tigrisdata · MIT · https://github.com/tigrisdata/skills/tree/HEAD/skills/conventional-commits/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
