Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

format-commit-message

verified

Structured commit message format with title, motivation, UX, and architecture sections.

View on GitHub

Marketplace

workaholic

qmu/workaholic

Plugin

core

development

Repository

qmu/workaholic

plugins/core/skills/format-commit-message/SKILL.md

Last Verified

February 4, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/qmu/workaholic/blob/main/plugins/core/skills/format-commit-message/SKILL.md -a claude-code --skill format-commit-message

Installation paths:

Claude
.claude/skills/format-commit-message/
Powered by add-skill CLI

Instructions

# Format Commit Message

Structured commit message format for all commits.

## Format

```
<title>

Motivation: <why this change was needed>

UX Change: <what changed for the user>

Arch Change: <what changed for the developer>

Co-Authored-By: Claude <noreply@anthropic.com>
```

## Title

Present-tense verb, what changed (50 chars max). No prefixes like `feat:` or `[fix]`.

Examples:
- Add session-based authentication
- Fix Mermaid slash character in labels
- Remove unused RegisterTool type

## Motivation

Why this change was needed. More than a sentence, but not a paragraph. Extract from ticket Overview.

## UX Change

What users will experience differently:
- New commands, options, or behaviors
- Changes to output format or error messages
- Write "None" if internal only

## Arch Change

What developers need to know:
- New files, components, or abstractions
- Modified interfaces or data structures
- Changes to workflow or component relationships
- Write "None" if no structural changes

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
985 chars