Initial commit

skills/git-commit/README.md

@@ -0,0 +1,147 @@
+# 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:
+```bash
+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:**
+```bash
+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:
+
+```bash
+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