git-workflow
Token-efficient git operations with security scanning and auto-split commits
When & Why to Use This Skill
This Claude skill optimizes the Git development workflow by integrating automated security scanning, token-efficient operations, and intelligent commit management. It ensures high-quality version control by enforcing standardized commit messages, preventing sensitive data leaks, and automatically organizing complex changes into logical commits.
Use Cases
- Automated Secret Prevention: Scans staged changes for API keys, tokens, and credentials to block insecure commits before they reach the repository.
- Intelligent Commit Splitting: Automatically analyzes large or mixed changes and suggests splitting them into distinct, type-specific commits (e.g., separating 'feat' from 'docs') for cleaner history.
- Standardized Git Messaging: Generates professional, imperative-style commit messages following the Conventional Commits specification to improve project maintainability.
- Efficient PR Lifecycle Management: Streamlines the pull request process by performing pre-checks against the main branch and generating structured PR summaries and test plans.
| name | git-workflow |
|---|---|
| description | "Token-efficient git operations with security scanning and auto-split commits" |
| autoInvoke | true |
| priority | high |
| model | haiku |
| allowed-tools | Bash, Read |
Git Workflow
Token-efficient git operations. Execute in 2-4 tool calls max.
Commit Workflow
Step 1: Stage + Analyze (Single Command)
git add -A && \
echo "=== STAGED ===" && \
git diff --cached --stat && \
echo "=== METRICS ===" && \
git diff --cached --shortstat | awk '{print "LINES:"($4+$6)" FILES:"NR}' && \
echo "=== SECURITY ===" && \
git diff --cached | grep -c -iE "(api[_-]?key|token|password|secret|credential)" | awk '{print "SECRETS:"$1}' && \
echo "=== GROUPS ===" && \
git diff --cached --name-only | awk '{
if ($0 ~ /\.(md|txt)$/) print "docs:"$0
else if ($0 ~ /test|spec/) print "test:"$0
else if ($0 ~ /package\.json|yarn\.lock|pnpm-lock/) print "deps:"$0
else if ($0 ~ /\.github|\.gitlab/) print "ci:"$0
else print "code:"$0
}'
If SECRETS > 0: STOP. Show matches. Block commit.
Step 2: Auto-Split Decision
Split commits if:
- Mixed types (feat + fix, code + deps)
- FILES > 10 with unrelated changes
- Multiple scopes (frontend + backend)
Keep single if:
- All files same type/scope
- FILES ≤ 3 and LINES ≤ 50
- Logically related changes
Step 3: Commit Message
Format: type(scope): description
Types:
feat- New featurefix- Bug fixdocs- Documentationchore- Maintenancerefactor- Code restructuretest- Testsperf- Performance
Rules:
- <72 chars
- Present tense, imperative
- No period at end
- Focus on WHAT not HOW
Step 4: Commit + Push
git commit -m "type(scope): description" && \
echo "✓ commit: $(git rev-parse --short HEAD) $(git log -1 --pretty=%s)"
Push only if user requests.
Output Format
✓ staged: 3 files (+45/-12 lines)
✓ security: passed
✓ commit: a3f8d92 feat(auth): add token refresh
✓ pushed: yes
Security Patterns (Block)
api[_-]?key
token
password
secret
private[_-]?key
credential
PR Workflow
Pre-PR Check
git fetch origin main && \
echo "=== COMMITS ===" && \
git log --oneline origin/main..HEAD && \
echo "=== CHANGES ===" && \
git diff --stat origin/main..HEAD
Create PR
gh pr create --title "type(scope): description" --body "## Summary
- [bullet points]
## Test Plan
- [testing steps]"
Version: 1.0.0