---
name: Writing Commit Messages
slug: writing-commit-messages
category: Writing
description: "Writing Commit Messages drafts Git commit messages that follow a project's style guidelines. It activates when the user asks to write or draft a commit message, inspects the diff, identifies subsystem and references, and applies the commit without pushing."
github: "https://github.com/herdrdev/herdr/tree/master/vendor/libghostty-vt/.agents/skills/writing-commit-messages"
language: Rust
stars: 28752
forks: 2045
install: "npx degit https://github.com/herdrdev/herdr/tree/master/vendor/libghostty-vt/.agents/skills/writing-commit-messages ~/.claude/skills/writing-commit-messages"
installs_to: ~/.claude/skills/writing-commit-messages
source_path: vendor/libghostty-vt/.agents/skills/writing-commit-messages/SKILL.md
collection_size: 5
category_size: 1012
collection_url: "https://dirskills.com/collections/herdrdev/herdr"
added: 2026-08-14T07:11:49.835Z
last_synced: 2026-08-14T07:11:49.835Z
canonical_url: "https://dirskills.com/skills/writing-commit-messages"
---

# Writing Commit Messages

Writing Commit Messages drafts Git commit messages that follow a project's style guidelines. It activates when the user asks to write or draft a commit message, inspects the diff, identifies subsystem and references, and applies the commit without pushing.

**Install:**

```bash
npx degit https://github.com/herdrdev/herdr/tree/master/vendor/libghostty-vt/.agents/skills/writing-commit-messages ~/.claude/skills/writing-commit-messages
```

## README

# Writing Commit Messages

Write commit messages that follow commit style guidelines for the project.

## Format

```
<subsystem>: <summary>

<reference issues/PRs/etc.>

<long form description>
```

## Rules

### Subject line

- **Subsystem prefix**: Use a short, lowercase identifier for the
  area of code changed (e.g., `terminal`, `vt`, `lib`, `config`,
  `font`). Determine this from the file paths in the diff. If
  changes span the macOS app, use `macos`. For GTK, use `gtk`. For
  build system, use `build`. Use nested subsystems with `/` when
  helpful and exclusive (e.g., `terminal/osc`).
- **Summary**: Lowercase start (not capitalized), imperative mood,
  no trailing period. Keep it concise—ideally under 60 characters
  total for the whole subject line.

### References

- If the change relates to a GitHub issue, PR, or discussion, list
  the relevant numbers on their own lines after the subject, separated
  by a blank line. E.g. `#1234`
- If there are no references, omit this section entirely (no blank
  line).

### Long form description

- Describe **what changed**, **what the previous behavior was**,
  and **how the new behavior works** at a high level.
- Use plain prose, not bullet points. Wrap lines at ~72 characters.
- Focus on the _why_ and _how_ rather than restating the diff.
- Keep the tone direct and technical without no filler phrases.
- Don't exceed a handful of paragraphs; less is more.

## Workflow

- If `.jj` is present, use `jj` instead of `git` for all commands.
- Run a diff to see what changes are present since the last commit.
- Identify the subsystem from the changed file paths.
- Identify any referenced issues/PRs from the diff context or
  branch name.
- Draft the commit message following the format above.
- Apply the commit
- Don't push the commit; leave that to the user.