generating-jj-commit-messages
Generates clear commit messages from jj diffs. Use when writing commit messages or reviewing staged changes.
When & Why to Use This Skill
This Claude skill automates the creation of professional commit messages for users of the Jujutsu (jj) version control system. By analyzing 'jj diff' output, it generates structured documentation that includes a concise summary, a detailed 'what and why' description, and a list of affected components, ensuring a clean and readable project history with minimal manual effort.
Use Cases
- Streamlining the development workflow by automatically generating descriptive commit messages after significant code changes.
- Ensuring team-wide consistency in version control history by following standardized best practices like present-tense usage and concise descriptions.
- Quickly summarizing complex diffs during the review of staged changes to identify impacted components and the rationale behind modifications.
- Improving project maintainability for Jujutsu users by shifting the focus from 'how' the code changed to 'why' it was changed.
| name | generating-jj-commit-messages |
|---|---|
| description | Generates clear commit messages from jj diffs. Use when writing commit messages or reviewing staged changes. |
Generating Commit Messages
Instructions
- Run
jj diff --gitto see changes - I'll suggest a commit message with:
- Summary under 50 characters
- Detailed description. Sacrifice grammar for the sake of concision.
- Affected components
Best practices
- Use present tense
- Explain what and why, not how
- Sacrifice grammar for the sake of concision.