commit

Format git commit messages with a Conventional Commits-style subject.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/mpsuesser/workspace --skill commit-mpsuesser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit
Source: https://github.com/mpsuesser/workspace/tree/main/dotconfig/pi/agent/skills/commit
Command: npx skills add https://github.com/mpsuesser/workspace --skill commit-mpsuesser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you format your git commit messages clearly and consistently so your project history stays readable and searchable.

Core Features & Use Cases

  • Conventional Commits-style subject: Ensures commits follow the <type>(<scope>): <summary> format with a concise, imperative summary.
  • Optional structured body guidance: Supports adding a body when needed, while discouraging breaking-change markers and sign-offs.
  • Safe staging/selection reminders: Prompts you to stage only the intended files, asking for clarification when file inclusion is ambiguous.

Quick Start

Review your git status and git diff, then create a Conventional Commits-style commit message for the intended changes (for example: feat(ui): improve settings page layout).

Frequently Asked Questions about commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a conventional commit message for my git changes?

A conventional commit message follows the `<type>(<scope>): <summary>` structure, keeping the imperative summary concise and under 72 characters without trailing periods. Optional structured bodies can be added for additional context.

What is the correct format for a conventional commits subject line?

The conventional commits subject line requires a type, an optional scope in parentheses, and a concise summary. This structure improves repository clarity and ensures project history stays readable across features, fixes, chores, or refactors.

How do I safely stage files before creating a conventional commit?

Review your `git status` and `git diff` to stage only the intended files. If file inclusion is ambiguous, the workflow prompts for clarification to ensure you commit exactly the intended code changes consistently.

Can I include a body and breaking change markers in my conventional commit?

You can add an optional structured body to your conventional commit for extra context. However, breaking-change markers and sign-offs are discouraged to keep the version control history clean and focused.

Does the conventional commits format work for local git workflows?

Yes, the conventional commits format applies directly to local git workflows. It helps you format commit messages clearly and consistently across features, fixes, chores, or refactors without needing external dependencies.

Why should I use a conventional commit format instead of free text?

Using a conventional commit format instead of free text keeps your repository history readable and searchable. Enforcing a structured `<type>(<scope>): <summary>` syntax ensures consistent code changes documentation across your project.