commit-message

commit-message is a skill for Claude Code, Codex from Lion-1209/Lion-Skills. It costs 15 tokens per session (1,247 once invoked), scanned A, a copy of commit-message, MIT.

A guide for writing clear, traceable Git commit messages using the Conventional Commits format, which labels changes such as features, bug fixes, documentation, and refactoring.

In plain words
What is it for?
Use it when committing code, especially after changes across several files. It helps choose the change type and scope, write a concise subject, describe the reason, and document migration steps for breaking changes.
Why use it?
It turns a confusing set of file changes into a short record of what changed and why. Clear history makes project evolution easier to understand and highlights changes that may break existing users.

Skill for Claude CodeCodex

Part of the lion-skills plugin — 13 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lion-1209/lion-skills/commit-message
Any agent
npx skills add Lion-1209/Lion-Skills --skill commit-message
Clone the repo
git clone --depth 1 https://github.com/Lion-1209/Lion-Skills

Made for: Claude Code, Codex.

Or install lion-skills, the plugin that ships this one along with the rest of its 13 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for commit-message

README.md
[![agentmods](https://agentmods.dev/badge/skills/lion-1209/lion-skills/commit-message.svg)](https://agentmods.dev/skills/lion-1209/lion-skills/commit-message)
Your own site
<a href="https://agentmods.dev/skills/lion-1209/lion-skills/commit-message"><img src="https://agentmods.dev/badge/skills/lion-1209/lion-skills/commit-message.svg" alt="Measured on agentmods" height="20"></a>
Per session 15 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,247 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00015 $0.01247
Opus 5 $0.00008 $0.00624
Sonnet 5 $0.00003 $0.00249
Haiku 4.5 $0.00002 $0.00125

Measured 5d ago against content hash 81379d0bd3e6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

commit-message scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to commit-message — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/commit-message/SKILL.md · 98 lines

How it starts

The opening of the file, as written. The whole thing — 98 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Commit Message

概述

把一团 diff 提炼成规范、可追溯的提交信息。核心:一条提交说清"做了什么"和"为什么",让未来的自己(和同事)能从提交历史里读懂项目演进。

何时使用

  • 写完代码要提交,需要写 commit message
  • 改了多处,不知怎么概括
  • 现有提交信息太笼统("update""fix bug"),要重写
  • 想统一团队提交规范

不该用:还没写完代码(先写代码);只想看 diff(用 git diff)。

核心内容

格式:Conventional Commits

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

<body 可选:为什么改>

<footer 可选:BREAKING CHANGE: ... / Closes #123>

破坏性变更(不向后兼容的改动)两种写法,二选一或并用:

  • ! 标记:紧贴 type/scope 之后、冒号之前,如 feat(api)!: 改用 token 鉴权替代 cookie——一眼标红,提醒 reviewer 注意。
  • 脚注 BREAKING CHANGE::放 footer,写清破坏了什么、怎么迁移,如 BREAKING CHANGE: /api/login 改为返回 token,前端需改用 Authorization 头——给受影响方具体的迁移指引。

破坏性变更必须二选一明确标注,别藏在普通提交里让下游踩坑。

type 选一个feat(新功能)、fix(修 bug)、docs(文档)、refactor(重构不改行为)、test(测试)、chore(构建/杂务)、perf(性能)。带可追溯业务变更的迁移脚本(如新增用户表)可算 feat,纯基础设施改动算 chore

从 diff 提炼三步

  1. 归类:主要是加功能(feat)、修 bug(fix)、还是重构(refactor)?
  2. 定 scope:影响哪个模块/文件?(如 authapiui)可省略。
  3. 写 subject:一行,祈使句,说"做了什么"不说"怎么做的",≤50 字符。

多处改动怎么办

  • 相关改动 → 一条提交,body 列要点
  • 不相关改动 → 拆成多条(用 git add -p 分块暂存)

判断"相不相关":这些改动服务于同一个目的吗?是 → 一条;否 → 拆。

灰色地带——"主线 + 顺带小修复":重构或加功能时顺手修了个同处的小 bug(例 1 就是这种),可以合并:主线作 subject,bug 修复在 body 一行带过。但若两件事跨文件、跨关注点、或各自都够大,就该拆。一个简单的尺子:能不能用一句话(一个 subject)概括全部改动?能 → 合;不能 → 拆。

body 写什么

为什么影响,不写代码细节(代码自己会说话):动机/背景、副作用/破坏性变更的迁移说明、关联 issue/PR(如 Closes #123)。破坏性变更的标注方式见上面「格式」节。subject 够清楚的小改动可以只写 subject,别硬凑 body。

语言

subject 跟随仓库现有风格(多数中文团队和本仓库用中文 subject;Conventional Commits 生态也常见英文)——没有仓库上下文时跟随团队语言;body 语言同 subject;用户明确偏好优先。

例子

例 1(单改动) — 把 useState 换成 useReducer:

refactor(auth): 用 useReducer 替换登录表单的状态管理

复杂的状态转换用 reducer 更清晰,也为后续多步校验做准备。
顺带修了 useEffect 未清理订阅导致的内存泄漏。

例 2(多相关改动) — 加登录接口 + 测试:

feat(auth): 实现邮箱密码登录接口

- 新增 /api/login 端点
- 加密码哈希校验
- 补单元测试覆盖成功/失败场景

例 3(该拆的) — 登录接口、迁移脚本、README 三件不相关事,拆三条:

feat(auth): 实现登录接口
chore(db): 添加用户表迁移脚本
docs: 更新 README 部署说明

常见错误

问题 修法
太笼统("update""改了点") 写清 type + 具体做了什么
一条提交塞多个无关改动 拆成多条
subject 写"怎么做"而非"做了什么" "用 useReducer 替换"而非"改了 state 逻辑"
只说现象不说动机 body 补上为什么

Read the full file on GitHub · 98 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 98 lines · 15 tokens per session scan A 81379d0bd3e6

Subscribe to this mod's changes

commit-message is a skill published in the GitHub repository Lion-1209/Lion-Skills (4 stars, last pushed 2mo ago), licensed MIT. It adds 15 tokens to every session and 1,247 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to commit-message, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

dependabot

Comprehensive guide for configuring and managing GitHub Dependabot. Use this skill when users ask about creating or optimizing dependabot.yml files, managing Dependabot pull requests, configuring dependency update strategies, setting up grouped updates, monorepo patterns, multi-ecosystem groups, security update…

boshi-xixixi/TraeSkill · 136 tokens

commit-message-storyteller

Analyzes git diffs or staged changes and generates narrative commit messages that explain WHY a change was made, not just what changed — following Conventional Commits format. Use when asked to "write a commit message", "generate a commit", "describe my changes", "what should I commit this as", "commit this"…

boshi-xixixi/TraeSkill · 98 tokens

conventional-commit

Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.

boshi-xixixi/TraeSkill · 45 tokens

git-commit

Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive…

boshi-xixixi/TraeSkill · 87 tokens

chinese-commit-conventions

中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用,不要根据上下文自动触发。.

jnMetaCode/superpowers-zh · 65 tokens

ship

Commit, push, and optionally create or update a PR for the current staged changes. Use when the user asks to "ship", "ship it", "ship changes", "commit push and PR", or "ship this".

tobihagemann/turbo · 47 tokens