writing-commit-messages

Q: How do I install writing-commit-messages?

Run npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill writing-commit-messages in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/writing-commit-messages/ (personal) or .claude/skills/writing-commit-messages/ (project).

by spencerpaulyCode Quality & Workflow

Write clear, conventional commit messages with proper type prefixes, scopes, and body content.

Installs: 457
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill writing-commit-messages

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads writing-commit-messages automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Writing Commit Messages

Write commit messages that are useful for humans and machines.

Format

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

<optional body>

<optional footer>

Subject Line Rules

50 characters or less for the subject
Use imperative mood: "add feature" not "added feature" or "adding feature"
Don't capitalize the first letter after the type prefix
No period at the end

Types

Type	When to use
`feat`	New user-facing feature
`fix`	Bug fix
`refactor`	Code restructuring without behavior change
`docs`	Documentation changes
`test`	Adding or updating tests
`chore`	Build, CI, tooling, deps
`perf`	Performance improvement
`style`	Formatting, whitespace (not CSS)
`ci`	CI/CD pipeline changes
`revert`	Reverting a previous commit

Scope (Optional)

The area of the codebase affected:

feat(auth): add OAuth2 login flow
fix(api): handle null response from payments endpoint
refactor(db): extract query builder into module

Body (When Needed)

Explain why, not what (the diff shows what):

fix(checkout): prevent duplicate order submissions

The submit button was not disabled after the first click,
allowing users to create multiple orders. This caused
duplicate charges in Stripe.

Footer (When Needed)

BREAKING CHANGE: rename `getUserById` to `findUser`

Closes #456
Co-authored-by: Name <email>

Examples

Good:

feat(dashboard): add real-time notification bell
fix: resolve race condition in WebSocket reconnect
refactor(api): consolidate error handling middleware
test: add integration tests for payment webhook
chore: upgrade TypeScript to 5.4

Bad:

fixed stuff
WIP
update
changes
asdf

When to Commit

Each commit should represent one logical change
Don't mix refactoring with feature work in the same commit
Don't commit half-working code (use git stash instead)
Commit early and often on feature branches, squash before merge if needed

Breaking Changes

If the commit introduces a breaking change:

Add ! after the type: feat(api)!: change auth token format
Add BREAKING CHANGE: in the footer with migration instructions

FAQ

What does the writing-commit-messages skill do?

Write clear, conventional commit messages with proper type prefixes, scopes, and body content.

How do I install writing-commit-messages?

Run npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill writing-commit-messages in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/writing-commit-messages/ (personal) or .claude/skills/writing-commit-messages/ (project).

Which AI agents can use writing-commit-messages?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is writing-commit-messages safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains writing-commit-messages?

It is published by spencerpauly in spencerpauly/awesome-cursor-skills. It has 457 recorded installs.