name: commit-helper
description: Generate clear, conventional commit messages from git diffs. Use when writing commit messages, reviewing staged changes, or preparing commits.

Commit Helper

Generate well-structured commit messages following conventional commit format.

Instructions

1. Run git diff --staged to see staged changes
2. Analyze the changes to understand:
3. What files were modified
4. What type of change (feat, fix, refactor, docs, etc.)
5. The scope/component affected
6. Generate a commit message with:
7. Summary line under 50 characters
8. Type prefix (feat, fix, docs, refactor, test, chore)
9. Optional scope in parentheses
10. Detailed body explaining what and why

Commit Types

• feat: New feature
• fix: Bug fix
• docs: Documentation changes
• refactor: Code restructuring without behavior change
• test: Adding or updating tests
• chore: Maintenance tasks

Best Practices

• Use present tense ("Add feature" not "Added feature")
• Explain what and why, not how
• Keep summary concise but descriptive
• Reference issue numbers when applicable

Example Output

feat(auth): add OAuth2 support for GitHub login

- Implement OAuth2 flow with PKCE
- Add token refresh mechanism
- Store tokens securely in encrypted storage

Closes #123