gh-anthemflynn-ccmp-plugins-git-commit/skills/git-commit/README.md

Git Commit Skill

Claude will help you write professional commit messages following industry standards (Conventional Commits).

Installation

1. Install git-commit.skill in Claude
2. That's it

Usage

Smart Analysis (NEW!)

Stage your changes and ask Claude to help:

You: "Help me commit"

Claude: [runs analyze-diff.py to examine your code]

Based on your changes to auth/oauth.py:
- Added OAuth2 authentication functions
- Modified 15 lines in auth module

Suggested commit:
git commit -m"feat(auth): add OAuth2 authentication"

The analyzer examines:

• File paths → suggests scope (e.g., auth, api, ui)
• Added code → suggests type (feat, fix, refactor)
• Function names → generates description
• Removed APIs → detects breaking changes

You can also run it standalone:

git add .
python scripts/analyze-diff.py        # Get suggestion
python scripts/analyze-diff.py --commit  # Auto-commit with suggestion

Manual Description

Or just describe what you changed:

You: "Help me write a commit - I added OAuth login"

Claude: git commit -m"feat(auth): add OAuth2 login support"

Claude will:

• Ask clarifying questions if needed
• Suggest the right commit type
• Format everything correctly
• Give you a ready-to-use git command

Slash Commands

Use these commands for quick access to specific features:

• /commit - Smart commit helper (analyzes code if staged, otherwise interactive)
• /validate <message> - Check if a commit message is valid
• /types - Show all commit types with examples
• /scopes - Learn about scopes with project-specific suggestions
• /breaking - Guide for creating breaking change commits
• /changelog - Generate formatted changelog from commits
• /version - Calculate next semantic version number
• /examples - Show real-world commit examples
• /fix - Help amend or fix recent commits

How /commit Works

Smart and Adaptive:

1. Has staged changes? → Analyzes your code automatically
2. No staged changes? → Asks what you changed, builds interactively
3. You described it already? → Uses your description

Example with staged changes:

git add auth/oauth.py

You: /commit

Claude: 📊 Analyzed your changes...
Suggested: git commit -m"feat(auth): add OAuth2 authentication"

Does this look good?

Example without staged changes:

You: /commit

Claude: No staged changes found. What did you change?

You: I added OAuth login

Claude: git commit -m"feat(auth): add OAuth login"

One command, smart behavior.

Examples of What to Ask

• "Help me commit this change: [describe what you did]"
• "How should I write a commit for fixing the login bug?"
• "Is this commit message okay? fix: bug"
• "I made a breaking change to the API, help me write the commit"

Commit Format

Claude follows this format:

type(scope): description

optional body

optional footer

Types: feat, fix, refactor, perf, style, test, docs, build, ops, chore

You don't need to memorize this - just describe what you did and Claude will format it correctly.

Optional: Git Hook

If you want automatic validation, copy the included script:

cp scripts/validate.py .git/hooks/commit-msg
chmod +x .git/hooks/commit-msg

Now all commits are validated before they're created.

That's It

No documentation to read. No commands to memorize. Just ask Claude for help.

---

What it does: Helps you write good commits
How to use it: Ask Claude naturally
Learning curve: Zero