commit-message
Skill3 starsChanged 52 days agoMITView on GitHub
Пишет коммит-сообщение, реально прочитав и осмыслив diff — не подставляя его в шаблон. Формат (subject/body, ветки) уже зафиксирован в CLAUDE.md → Git conventions; этот скилл — про содержание. Использовать, когда пользователь просит закоммитить, написать сообщение коммита, или перед тем как предложить `git commit`.
74 other projects use a version of this.
Adopted by
Most recently taken up by
- Eclipter/agentstheir own version, first seen Nov 16, 2026
- travissmithv1/claude-skillstheir own version, first seen Nov 16, 2026
- antick/skillstheir own version, first seen Nov 16, 2026
- beecode-rs/claude-skillstheir own version, first seen Nov 16, 2026
- Citxen/Claude-Skillstheir own version, first seen Nov 16, 2026
- michagrandel/skillstheir own version, first seen Nov 16, 2026
Used with
Projects with it also use pr-description, changelog and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MicrosoftSkillpr-description
Draft Nacelle PR titles, pull request descriptions, commit titles, commit descriptions, and squash commit messages. Use when asked for PR or commit wording, a branch summary, or a PR description that can be used in a commit. Omit validation sections from commit bodies and remove filler.
Also in 9 projects that use this
HashiCorpSkillchangelog
Add a `.changelog/<PR_NUMBER>.txt` entry for a GitHub Pull Request, commit, and push.
Also in 3 projects that use this
GitHubSkillrefactor
Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.
Also in 3 projects that use this
GoogleSkillcode-review
Adversarial systems, concurrency, memory-model, and architecture code review protocol. Use this skill whenever asked to review code, PRs, diffs, or branches in Filament.
Also in 7 projects that use this
GoogleSkillgrilling
Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
Also in 3 projects that use this
OpenAISkillbrainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Also in 3 projects that use this
- +2 more from google
Other versions74 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 74
- zulip/zulip★ 26ksame name
- mergisi/awesome-openclaw-agents★ 4.1ksame name
- AltraMayor/f3★ 3.4ksame name
- github/copilot-cli-for-beginners★ 2.9ksame name
- AcademySoftwareFoundation/OpenImageIO★ 2.4ksame name
- sheshbabu/zen★ 1.2ksame name
- s-kostyaev/ellama★ 963same name
- tektoncd/operator★ 606same name
- danielvm-git/bigpowers★ 292same name
- rshdhere/vibecheck★ 213same name
64 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- docs-syncSkill
- gameplay-testingSkill
- project-statusSkill
- shipSkill
The file
Files
Коммит-сообщения: читать diff, а не подставлять в шаблон
Формат уже задан в CLAUDE.md → «Git conventions»: `Область: что сделано» в
subject, без Conventional Commits, тело о ПОЧЕМУ не о ЧТО, без списка файлов.
Здесь эти три строки не повторяются — здесь то, что в CLAUDE.md сознательно не
уместилось: как получить содержание тела, а не только его форму.
Суть: diff — это симптом или решение, а не список строк
Плохой процесс: пробежать git diff построчно, пересказать «добавлено X,
удалено Y», подставить пересказ в шаблон. Так получается сообщение, которое
технически по форме верно и ничего не объясняет — ровно то, что этот скилл
должен предотвратить.
Настоящие коммиты проекта (полные примеры — references/style-examples.md) устроены иначе:
- Багфикс — сначала диагноз, потом лечение. Не «поправлена позиция при вселении», а: в чём разные точки отсчёта у тела и у игрока, почему игрок проваливался, почему лечение — «взять офсет из коллайдера», а не константа.
- Фича — сначала чего не хватало по существу, потом раскладка решения и явно названные отвергнутые варианты («иначе выбор сводится к…», «дублировать ещё и здесь — два источника правды»).
- Правки задним числом ссылаются на предыдущий коммит по хэшу, если diff
его откатывает или уточняет — не «раньше было неправильно», а
git log -p -- <файл>/git blame, чтобы найти, какой коммит уточняется, и назвать его. - Никогда не перечисляет изменённые файлы — это уже есть в самом diff.
- Числа и проценты — только когда они реально посчитаны (тест прогнан, профайлер запущен), не для солидности.
- Масштаб тела соразмерен масштабу diff: одна правка — два абзаца, даже маленькая (см. форму «HUD: карта в панель» в примерах); диагностика на CI — список из нескольких независимых причин, потому что их правда несколько.
Порядок работы
- Что вообще коммитим.
git status(никогда-uall) иgit diff. Если что-то уже в индексе — читатьgit diff --cached, это и есть предмет коммита; если нет — прочитатьgit diffпо рабочему дереву и решить вместе с пользователем, что стоит в этот коммит, а что нет (неgit add -A— конкретные пути, см. общий протокол коммитов). - Прочитать diff по намерению, не по строкам. Если контекста в диффе не
хватает, чтобы понять, что именно изменилось в поведении — дочитать файл
целиком (
Read), не гадать по трём строкам контекста. Хунк в компоненте + хунк в системе + хунк в сцене часто — одно намерение, а не три отдельных. - Смотреть, что удалено и что было ДО, не только что стало. Диагноз бага виден в разнице между старым и новым условием/веткой; дизайн-решение — в том, какая структура заменена (лист характеристик → компоненты, множитель → абсолютное число). Комментарии в диффе, особенно WHY-комментарии по правилу проекта, часто уже содержат готовую причину — не придумывать её заново, если она написана прямо в патче.
- Сгруппировать хунки по потокам замысла, не по файлам и не по папкам. Одна причина, тронувшая пять файлов, — один поток, один абзац. Две несвязанные причины в одном файле — два потока, два абзаца.
- Свериться со словарём проекта. Если правка касается именованного
инварианта («Правило v9», модель распада, двери↔граф) — назвать его так,
как он назван в
docs/astral-genesis/(через картуdocs-sync), а не изобретать синонимы для того же самого. Область в subject — тоже по возможности из уже использованного словаря (references/style-examples.md, раздел «Словарь Область»), а не новое имя для той же подсистемы. - Составить subject:
Область: что сделано, без точки в конце, по-русски. Две явно связанные области — через «и» («Риг тел и геометрия комнат»). Действительно несвязанная россыпь (заметки, план, разбор бэклога) — общая область вроде «Планирование», раз в истории так уже делали; но см. следующий пункт. - Составить тело: абзац на поток, в порядке значимости, форма — по образцам выше. Bullets — только когда внутри потока правда несколько отдельных решений (не как замена абзацу).
- Упомянуть headless-проверку одной строкой в конце, только если она
реально прогонялась в этой сессии (см. навык
gameplay-testing) — придуманная строка «проверено» хуже отсутствующей. - Показать черновик пользователю. Сам
git add/git commit— по общему протоколу (конкретные файлы, heredoc,Co-Authored-By, коммитить только когда попросили).
Когда НЕ сводить в один коммит
Если diff — это две причины, которые не связаны и не бьют по одной и той же
цели (не «фикс + рефакторинг вокруг него», а буквально два разных дела,
случайно оказавшихся в одном рабочем дереве) — сказать об этом прямо и
предложить разбить на отдельные коммиты (git add по конкретным файлам под
каждый), прежде чем писать сообщение на всё сразу. Легитимный грабж-бэг вроде
«Планирование: баг вселения, экран итогов, коридоры, звук, настройки, арт» в
истории проекта тоже есть — это нормально, когда коммит и есть заметки/план по
нескольким темам сразу, а не код с двумя случайно сбившимися в одно рабочее
дерево задачами.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

