Agent skill

Git Commit Convention

by 7-e1even in 7-e1even/learn-agent

写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则. An agent skill from 7-e1even/learn-agent.

MITAuto-check passedDevelopment

Install Git Commit Convention

skills CLI
$ npx skills add 7-e1even/learn-agent --skill git-commit-convention -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 7-e1even/learn-agent git-commit-convention --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/7-e1even/learn-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/notes/s10_prompt_assembly/skills/git-commit-convention .claude/skills/git-commit-convention && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
git-commit-convention
GitHub stars
282
Token cost
~206 tokens
SKILL.md length
67 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则. An agent skill from 7-e1even/learn-agent.

  • Works in 3 steps: git diff --staged… → 这个提交单独 revert 时,代码库还能编译/测试通过吗?不能 →… → subject 能让三个月后的自己一眼看懂吗?
  • Tasks that involve Commit messages
  • SKILL.md covers 格式, type 怎么选, footer and 提交前自查
  • Calls git

What it does

Git Commit Convention is an agent skill from 7-e1even/learn-agent. 写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则。

Its SKILL.md is about 210 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Commit messages. It works with Git, OpenAI and Node.js. The repository describes itself as: 学习Agent开发的笔记,尝试让Agent从可用到可靠. The licence is MIT.

When your agent uses it

  • Tasks that involve Commit messages

Example prompts

  • “/git-commit-convention”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. git diff --staged 过一遍:有没有混进无关文件(调试代码、锁文件意外变更)?
  2. 这个提交单独 revert 时,代码库还能编译/测试通过吗?不能 → 拆分方式有问题。
  3. subject 能让三个月后的自己一眼看懂吗?

What it can do on your machine

Read from SKILL.md and the folder at commit 8664245. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Git Commit Convention loads about 206 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 67 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~206

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 7-e1even/learn-agent at commit 8664245, republished under its MIT licence (© 7-e1even). 67 words, ~206 tokens.

Download SKILL.mdSave it as .claude/skills/git-commit-convention/SKILL.md (or your agent's skills folder).
name
git-commit-convention
description
写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则。

Git 提交规范

格式

<type>(<scope>): <subject>

<body>

<footer>
  • type 必选,scope 可选(改动涉及的模块/目录名),subject 必选。
  • subject 用祈使句("add" 不是 "added"),不加句号,不超过 50 字符。
  • body 讲为什么改,不复述 diff 里能看到的"改了什么"。
  • 一次提交只做一件事:重构和功能修改不混在同一个提交里。

type 怎么选

type用于
feat新功能(用户可感知的行为变化)
fix修 bug(引用 issue 编号写进 footer)
refactor不改行为的结构调整
test只增改测试
docs只改文档/注释
chore构建、依赖、CI 等工程杂务

拿不准 feat 还是 fix:问"用户之前的预期是什么"——之前就该这样但没做到 = fix;之前没有这个预期 = feat。

  • 不兼容变更:以 BREAKING CHANGE: 开头,说明迁移方法。
  • 关联 issue:Closes #123。

提交前自查

  1. git diff --staged 过一遍:有没有混进无关文件(调试代码、锁文件意外变更)?
  2. 这个提交单独 revert 时,代码库还能编译/测试通过吗?不能 → 拆分方式有问题。
  3. subject 能让三个月后的自己一眼看懂吗?

© 7-e1even, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in notes/s10_prompt_assembly/skills/git-commit-convention of 7-e1even/learn-agent.

Open the folder on GitHubat commit 8664245

Compare with similar skills

Git Commit Convention next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Git Commit Convention compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Commit Convention this skill7-e1even/learn-agent282—~206Automated safety check: PassMIT
Git Commit Push PRdevoxx/DevoxxGenieIDEAPlugin684—~698Automated safety check: NotesMIT
Open Code Review CLIalibaba/open-code-review44k—~3.1kAutomated safety check: PassApache-2.0
Codexskills-directory/skill-codex1.5k3 repos~1.8kAutomated safety check: PassMIT
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0

Similar skills

  • Git Commit Push PR

    devoxx/DevoxxGenieIDEAPlugin

    Commit all changes, push to remote, and open a pull request in one go.

    684 GitHub stars~698 tokensUpdated 8 days ago
    DevelopmentAuto-check: notes
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    44k GitHub stars~3.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Codex

    skills-directory/skill-codex

    A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing

    1.5k GitHub starsUsed in 3 repos~1.8k tokens
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.

    41k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    102k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes

More from 7-e1even/learn-agent

  • Code Review Checklist

    7-e1even/learn-agent

    审查代码改动(review diff / PR)时使用——按固定清单过正确性、边界、错误处理和测试盲区,避免只看顺眼不顺眼。

    282 GitHub stars~176 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Git Commit Convention

What does Git Commit Convention do?

写 git 提交信息、整理提交历史时使用——Conventional Commits 的格式、类型选择和拆分原则. An agent skill from 7-e1even/learn-agent. Git Commit Convention is an agent skill from 7-e1even/learn-agent.

When should I use Git Commit Convention?

Git Commit Convention fits situations like: tasks that involve Commit messages.

How do I install Git Commit Convention in Claude Code?

Run `npx skills add 7-e1even/learn-agent --skill git-commit-convention -a claude-code`. Or copy the skill folder (notes/s10_prompt_assembly/skills/git-commit-convention in 7-e1even/learn-agent) into .claude/skills/git-commit-convention in your project. Claude Code loads it when a task matches its description.

How do I install Git Commit Convention in Codex?

Run `npx skills add 7-e1even/learn-agent --skill git-commit-convention -a codex`. Or copy the skill folder (notes/s10_prompt_assembly/skills/git-commit-convention in 7-e1even/learn-agent) into .agents/skills/git-commit-convention in your project. Codex loads it when a task matches its description.

Can I use Git Commit Convention in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 7-e1even/learn-agent --skill git-commit-convention -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/git-commit-convention, .gemini/skills/git-commit-convention, .github/skills/git-commit-convention and .opencode/skills/git-commit-convention in your project.

What does Git Commit Convention need to run?

Going by SKILL.md and its folder, Git Commit Convention needs the command-line tools its instructions call (git).

Does Git Commit Convention access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Git Commit Convention safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Git Commit Convention use?

Git Commit Convention is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Git Commit Convention use?

About 206 tokens (SKILL.md is roughly 824 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Git Commit Convention?

Skills that share tags, products or a category with Git Commit Convention: Git Commit Push PR (devoxx/DevoxxGenieIDEAPlugin, 684 stars), Open Code Review CLI (alibaba/open-code-review, 44k stars), Codex (skills-directory/skill-codex, 1.5k stars) and React Router Release Notes Prep (remix-run/react-router, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Commit Convention?

7-e1even (a GitHub user) maintains it in 7-e1even/learn-agent, which has 282 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 5, 2026.

Source: 7-e1even/learn-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.