Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.
Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.
What it does
Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.
When to use it
The official description does not include a separate “Use when”. Per the spec, agents activate this skill when the task matches keywords in that description.
How agents load it
Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Instructions; Workflow; Commit Message Structure; Examples; Validation; Final Step. It includes spec-recommended sections: step-by-step instructions, input/output examples.
File analysis
File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.
Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.
DiscoverThe client exposes names and descriptions to the agent.
ActivateYour request or the task context selects the skill and loads its instructions.
Load resourcesReferenced scripts, documentation and assets are used when needed.
Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.
Ask your Agent to install
Copy these instructions to a compatible agent and confirm the target directory matches your client.
Install the agent skill "conventional-commit" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-f73e8fb8de27c575-Conventional-Commit.html
Save it as .cursor/skills/conventional-commit/SKILL.md or .claude/skills/conventional-commit/SKILL.md and keep the frontmatter name and description exactly as-is.
The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.
Readable layout
---
name: conventional-commit
description: 'Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.'
---
### Instructions
```xml
This file contains a prompt template for generating conventional commit messages. It provides instructions, examples, and formatting guidelines to help users write standardized, descriptive commit messages in accordance with the Conventional Commits specification.
```
### Workflow
**Follow these steps:**
1. Run `git status` to review changed files.
2. Run `git diff` or `git diff --cached` to inspect changes.
3. Stage your changes with `git add `.
4. Construct your commit message using the following XML structure.
5. After generating your commit message, Copilot will automatically run the following command in your integrated terminal (no confirmation needed):
```bash
git commit -m "type(scope): description"
```
6. Just execute this prompt and Copilot will handle the commit for you in the terminal.
### Commit Message Structure
```xml
feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert
()
A short, imperative summary of the change
(optional: more detailed explanation)
(optional: e.g. BREAKING CHANGE: details, or issue references)
```
### Examples
```xml
feat(parser): add ability to parse arrays
fix(ui): correct button alignment
docs: update README with usage instructions
refactor: improve performance of data processing
chore: update dependencies
feat!: send email on registration (BREAKING CHANGE: email service required)
```
### Validation
```xml
Must be one of the allowed types. See https://www.conventionalcommits.org/en/v1.0.0/#specification
Optional, but recommended for clarity.
Required. Use the imperative mood (e.g., "add", not "added").
Optional. Use for additional context.
Use for breaking changes or issue references.
```
### Final Step
```xml
git commit -m "type(scope): description"
Replace with your constructed message. Include body and footer if needed.
```