Message Generation Skill - Semantic Commit Message Generation

Generate well-formatted commit messages that follow the Conventional Commits standard with proper type, scope, subject, body, and footer.

Operations

•subject - Generate subject line: <type>(<scope>): <description>
•body - Compose commit body with bullet points
•footer - Add footer with breaking changes and issue references
•validate - Check conventional commits compliance
•complete - Generate full commit message (subject + body + footer)

Router Logic

Parse $ARGUMENTS to determine which operation to perform:

•
Extract operation from first word of $ARGUMENTS
•
Extract remaining arguments as operation parameters
•
Route to appropriate instruction file:
- •"subject" → Read /home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/generate-subject.md
- •"body" → Read /home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/write-body.md
- •"footer" → Read /home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/add-footer.md
- •"validate" → Read /home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/validate-message.md
- •"complete" → Read /home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/complete-message.md
•
Execute instructions with parameters
•
Return formatted commit message or validation results

Error Handling

•If operation is unknown, list available operations
•If required parameters are missing, show required format
•If message validation fails, provide specific corrections
•If character limits exceeded, suggest rewording

Usage Examples

bash

# Generate subject line only
/message-generation subject type:feat scope:auth description:"add OAuth authentication"

# Write commit body
/message-generation body changes:"Implement OAuth2 flow,Add provider support,Include middleware"

# Add footer with issue references
/message-generation footer breaking:"authentication API changed" closes:123

# Validate existing message
/message-generation validate message:"feat(auth): add OAuth"

# Generate complete commit message
/message-generation complete type:feat scope:auth files:"src/auth/oauth.js,src/auth/providers.js"

Conventional Commits Format

Message Structure:

code

<type>(<scope>): <subject>          ← Max 50 chars, imperative mood

<body>                               ← Optional, wrap at 72 chars
- Bullet point describing change 1
- Bullet point describing change 2

<footer>                             ← Optional
BREAKING CHANGE: description
Closes #123, #456

Valid Types (priority order):

•feat - New feature
•fix - Bug fix
•docs - Documentation only
•style - Formatting (no code change)
•refactor - Code restructuring
•perf - Performance improvement
•test - Test additions/updates
•build - Build system or dependencies
•ci - CI/CD configuration
•chore - Other maintenance
•revert - Revert previous commit

Base directory: /home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation

Current request: $ARGUMENTS

Parse operation and route to appropriate instruction file.