A skill that enforces the Conventional Commits specification for git messages to enable automated changelogs and semantic versioning.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install conventional-commits
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 conventional-commits 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 Conventional Commits?
The Conventional Commits skill provides a lightweight convention for creating an explicit commit history. By following a structured format, it makes it easier for automated tools to parse your project history, generate changelogs, and determine the next semantic version bump. This skill is a vital component of the Openclaw Skills ecosystem for developers who value repository maintainability and automation.
By implementing this specification, your AI agent ensures that every code change is categorized by type and scope. This consistency allows teams to understand the evolution of a codebase at a glance, distinguishing between new features, bug fixes, and breaking changes without manually reviewing code diffs.
Conventional Commits Use Cases
- Formatting all git commits to follow industry standards
- Generating automated changelogs for project releases
- Automating semantic versioning (SemVer) based on commit types
- Providing clear context for pull request merge commits
- Improving searchability within git history for specific fixes or features
How Conventional Commits Works
- The agent analyzes the code changes to identify the nature of the update (e.g., a new feature or a bug fix).
- A specific type is selected from the allowed list, such as feat, fix, docs, or refactor.
- An optional scope is identified to provide context on which part of the codebase was affected.
- A concise, imperative description is written to summarize the change without capitalization or a trailing period.
- If necessary, a detailed body and footer are added to explain the motivation or document breaking changes.
- The final message is assembled into the standard format: type(scope): description.
Conventional Commits Setup
To integrate this functionality into your workflow, ensure your agent is configured to use the conventional-commits definition from the Openclaw Skills repository. You can verify the configuration or manually trigger a formatted commit using the following logic:
# Example of a commit formatted by this skill
git commit -m "feat(auth): add OAuth2 provider support"
Conventional Commits Data Schema & Taxonomy
The skill organizes commit metadata into a structured text format. The schema ensures that each part of the message serves a specific purpose for both humans and automated tools:
| Field | Requirement | Description |
|---|---|---|
| Type | Required | The category of change (e.g., feat, fix, chore) |
| Scope | Optional | The specific module or file affected |
| Description | Required | A short summary in imperative mood |
| Body | Optional | Detailed explanation of the "what" and "why" |
| Footer | Optional | External references or BREAKING CHANGE notices |
Conventional Commits Advanced Features
- Support for breaking change indicators using the ! symbol after the type/scope for immediate visibility
- Automatic correlation between commit types and SemVer (e.g., fix maps to PATCH, feat maps to MINOR)
- Handling of multi-paragraph bodies for complex architectural changes
- Support for multiple footers to link to issue trackers or specify reviewers
- Built-in validation to avoid common mistakes like past-tense descriptions or improper capitalization
SKILL.md
Loading
Related Openclaw Skills
Pet Sitter Client Intake Form Generator
A specialized tool for pet care professionals to generate branded, fillable PDF client intake and onboarding forms with ease.
VibeTunnel
A comprehensive tool for managing, monitoring, and controlling terminal sessions through the VibeTunnel REST API.
DevTools Secrets
A comprehensive secrets management workflow integrating mise, fnox, and infisical to ensure secure environment variable injection and credential hygiene.
Blowfish Solana Token Launch
Automate the deployment of Solana tokens through the Blowfish Agent API with integrated Meteora Dynamic Bonding Curve support.
Obsidian Daily Notes
A comprehensive CLI-based skill for managing Obsidian daily journals, tasks, and search queries within an AI agent workflow.
pass - The Standard Unix Password Manager
A lightweight, terminal-based password manager that uses GPG encryption and a simple file-system hierarchy to secure your credentials.
METADATA
Featured*
