git-workflow

Token-efficient git operations with security scanning and auto-split commits

⭐3stars🔀2forks📁View on GitHub🕐Updated Jan 8, 2026

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.
namegit-workflow
description"Token-efficient git operations with security scanning and auto-split commits"
autoInvoketrue
priorityhigh
modelhaiku
allowed-toolsBash, 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 feature
  • fix - Bug fix
  • docs - Documentation
  • chore - Maintenance
  • refactor - Code restructure
  • test - Tests
  • perf - 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