Enforces strict Conventional Commits v1.0.0 and Trunk-Based Development guardrails for atomic, professional git workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install commit-message-writing
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install commit-message-writing using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Commit Message Writing?
The Commit Message Writing skill is a specialized tool designed to bring professional-grade discipline to your version control workflow. It enforces the Conventional Commits v1.0.0 specification while maintaining Trunk-Based Development guardrails, ensuring that every contribution to your codebase is clear, machine-readable, and atomic. By utilizing this approach within Openclaw Skills, developers can automate changelog generation and simplify the peer review process.
This skill goes beyond simple formatting by providing logical rules for when to split changes and how to manage short-lived branches. It transforms the often-overlooked task of writing commit messages into a strategic part of the development lifecycle, ensuring that project history remains clean and SemVer-compliant.
Commit Message Writing Use Cases
- Preparing a commit and staging changes to ensure atomic discipline.
- Planning branch strategies for new features, bug fixes, or documentation updates.
- Deciding whether to split mixed changes into multiple units of work.
- Reviewing pull requests to verify compliance with repository standards.
- Automating the generation of release notes and version increments.
How Commit Message Writing Works
- Scan the current repository state using git status and diff statistics to identify staged changes.
- Verify that the current environment is a dedicated short-lived branch to prevent long-lived divergence.
- Analyze the logical units of work to determine if changes should be split into multiple commits.
- Select the most accurate commit type such as feat, fix, or refactor based on the change impact.
- Draft the commit message using imperative, lowercase descriptions and properly formatted footers.
- Run the local validation script to ensure the message meets all schema requirements before finalizing.
Commit Message Writing Setup
To get started with this skill for Openclaw Skills, ensure you have the validation script available in your local repository.
# Verify your current git status
git status --short
# Test the validation script with a sample message
python3 scripts/validate_commit_message.py --message "feat(auth): add login validation"
Commit Message Writing Data Schema & Taxonomy
This skill utilizes a structured taxonomy for commit metadata to ensure consistency across the development team.
| Component | Format | Description |
|---|---|---|
| Type | lowercase | Indicates the intent of the change (e.g., feat, fix, docs) |
| Scope | (noun) | The specific area of the codebase affected by the change |
| Breaking Change | ! or footer | Denotes an API-breaking change affecting SemVer major versions |
| Description | imperative | A brief, lowercase summary under 72 characters |
| Footer | Token: value | Metadata for issue tracking or breaking change details |
Commit Message Writing Advanced Features
- Enforces Trunk-Based Development by requiring short-lived, narrow branches.
- Automatic detection of mixed concerns to trigger commit splitting rules.
- Integration with local Python-based validation scripts for pre-commit checks.
- Strict SemVer mapping to commit types for automated release orchestration.
- Comprehensive footer support for managing breaking changes and external references within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Ecommerce Copy Humanizer FR
A specialized tool for transforming robotic or translated French ecommerce copy into natural, high-converting language while preserving commercial intent.
GitHub Repo Analyzer Skill
A powerful repository intelligence tool for analyzing GitHub activity, tech stacks, and contributor trends.
Ecommerce Copy Humanizer TH
A specialized tool for converting robotic or machine-translated Thai ecommerce text into natural, native-sounding sales copy.
opc-product-manager
A high-precision product strategy skill that converts raw ideas into structured, build-ready technical specifications for AI coding agents.
Ecommerce Copy Humanizer
A specialized AI agent skill designed to strip away robotic patterns from ecommerce copy while maintaining high-conversion selling intent.
Claw Insights Snapshot
A fast, server-rendered tool for generating visual status cards and metrics reports for your AI agent.
Featured*
