1natsu conventional commits

Skill 1natsu-vacation/agent-skills/skills/1natsu-conventional-commits

Conventional Commitsのフォーマット、タイプ、スコープ、破壊的変更、本文・フッターの書き方が必要なときに自動的に参照される内部リファレンス。コミットメッセージやPRタイトルの作成時に他のスキルから利用される。From its SKILL.md

Install

npx -y skills add 1natsu-vacation/agent-skills --skill 1natsu-conventional-commits

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.9 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

Conventional Commits リファレンス

Conventional Commits の包括的なリファレンス。

いつ使うか

コミットメッセージを書くとき
PRタイトルを作成するとき
変更履歴の分類が必要なとき

フォーマット

<type>(<scope>): <description>

[任意の本文]

[任意のフッター]

タイプリファレンス

タイプ	用途	例
`feat`	新機能	`feat(auth): add OAuth2 login`
`fix`	バグ修正	`fix(api): resolve timeout error`
`docs`	ドキュメント	`docs(api): add endpoint examples`
`style`	フォーマット変更、ロジック変更なし	`style(components): fix indentation`
`refactor`	コード再構成、動作変更なし	`refactor(utils): simplify validation`
`perf`	パフォーマンス改善	`perf(queries): optimize database calls`
`test`	テストの追加・更新	`test(auth): add login flow tests`
`build`	ビルドシステムや依存関係	`build(webpack): update config`
`ci`	CI/CD設定	`ci(actions): add test workflow`
`chore`	メンテナンスタスク	`chore(deps): update dependencies`
`revert`	以前のコミットの取り消し	`revert: feat(auth): add OAuth2`

description のルール

絵文字なし
命令形を使う："add"（"added" や "adds" ではなく）
先頭を大文字にしない
末尾にピリオドをつけない
可能なら50文字以内に収める

スコープのガイドライン

スコープは任意。影響範囲を示す：

モジュール別： feat(auth):, fix(payment):, docs(api):

コンポーネント別： feat(button):, fix(modal):, style(navbar):

レイヤー別： feat(frontend):, fix(backend):, refactor(database):

スコープなし（グローバルな変更）：chore: update all dependencies

破壊的変更

タイプ/スコープの後に ! を付けて示す：

feat(api)!: change endpoint response format

BREAKING CHANGE: API responses now use camelCase instead of snake_case

本文のガイドライン

descriptionだけでは不十分な場合、本文でコンテキストを補足する：

fix(parser): handle nested quotes in CSV fields

パーサーがクォート文字列内のカンマを含むすべてのカンマで分割していた。
クォートの深さを追跡するステートを追加し、フィールド境界を
正しく識別できるようにした。

descriptionとは空行で区切る
何をなぜ変更したかを説明する（どうやっては不要）
1行72文字で折り返す

フッター

破壊的変更やissue参照に使う：

feat(api): change authentication endpoint

BREAKING CHANGE: /auth/login now requires email instead of username

Refs: #123

カテゴリ別の例

機能追加

feat(search): add fuzzy search capability
feat(export): support CSV export
feat(i18n): add Japanese localization

バグ修正

fix(validation): prevent empty email submission
fix(cache): resolve race condition in cache updates
fix(auth): handle expired token gracefully

パフォーマンス

perf(images): implement lazy loading
perf(queries): add database indexes
perf(bundle): reduce JavaScript bundle size

リファクタリング

refactor(auth): extract validation logic
refactor(components): convert to TypeScript
refactor(api): consolidate duplicate code

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 2 of the 12 instructions most pr commit review skills give in ~1.2k tokens

Counted across 1,055 of the 1,911 authors here whose files we hold, read 2026-09-06

Use conventional commit message formatin 150 of 1055, across 145 files
Announce skill usage at startin 78 of 1055
Use imperative mood for commit descriptionshere, and in 54 of 1055, across 51 files
Add directory to gitignore if not ignoredin 52 of 1055, across 41 files
Use imperative mood for commit subjectin 52 of 1055
Run tests to verify clean baselinein 42 of 1055, across 32 files
Push branch to originin 40 of 1055, across 38 files
Verify worktree directory is ignored before creationin 39 of 1055, across 32 files
Delete branches after mergingin 38 of 1055, across 30 files
Create worktree with new branchin 37 of 1055, across 32 files
Wrap body text at 72 charactershere, and in 36 of 1055, across 34 files
Auto-detect and run project setupin 35 of 1055, across 27 files

Said here and by no other author read

separate description and body with empty line

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.