Agent skill

git-workflow

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

Stars 14
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/nguyenthienthanh/aura-frog/tree/main/aura-frog/skills/git-workflow

SKILL.md

Git Workflow

Token-efficient git operations. Execute in 2-4 tool calls max.


Commit Workflow

Step 1: Stage + Analyze (Single Command)

bash
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

bash
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

bash
git fetch origin main && \
echo "=== COMMITS ===" && \
git log --oneline origin/main..HEAD && \
echo "=== CHANGES ===" && \
git diff --stat origin/main..HEAD

Create PR

bash
gh pr create --title "type(scope): description" --body "## Summary
- [bullet points]

## Test Plan
- [testing steps]"

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results