sc-git

SKILL.md

Git Operations Skill

Intelligent git operations with smart commit generation.

Quick Start

# Status analysis
/sc:git status

# Smart commit
/sc:git commit --smart-commit

# Interactive merge
/sc:git merge feature-branch --interactive

Behavioral Flow

  1. Analyze - Check repository state and changes
  2. Validate - Ensure operation is appropriate
  3. Execute - Run git command with automation
  4. Optimize - Apply smart messages and patterns
  5. Report - Provide status and next steps

Flags

Flag Type Default Description
--smart-commit bool false Generate conventional commit message
--interactive bool false Guided operation mode

Evidence Requirements

This skill does NOT require hard evidence. Git operations are self-documenting through:

  • Commit history
  • Branch state
  • Repository logs

Operations

Status Analysis

/sc:git status
# Repository state with change summary
# Actionable recommendations

Smart Commit

/sc:git commit --smart-commit
# Analyzes changes
# Generates conventional commit message
# Format: type(scope): description

Branch Operations

/sc:git branch feature/new-feature
/sc:git checkout main
/sc:git merge feature-branch

Interactive Operations

/sc:git merge feature --interactive
# Guided merge with conflict resolution
# Step-by-step assistance

Commit Message Format

Smart commits follow Conventional Commits:

type(scope): description

[optional body]

[optional footer]

Types:

  • feat - New feature
  • fix - Bug fix
  • docs - Documentation
  • refactor - Code restructuring
  • test - Test additions
  • chore - Maintenance

Examples

Analyze Changes

/sc:git status
# Summary of staged/unstaged changes
# Recommended next actions

Commit with Analysis

/sc:git commit --smart-commit
# Scans diff, generates message:
# feat(auth): add JWT token refresh mechanism

Guided Merge

/sc:git merge feature/auth --interactive
# Conflict detection and resolution guidance
# Step-by-step assistance

MCP Integration

PAL MCP (Validation & Review)

Tool When to Use Purpose
mcp__pal__precommit Before commit Comprehensive change validation
mcp__pal__codereview Before merge Code quality review of changes
mcp__pal__consensus Merge conflicts Multi-model resolution strategy
mcp__pal__debug Git issues Investigate repository problems

PAL Usage Patterns

# Pre-commit validation (--smart-commit)
mcp__pal__precommit(
    path="/path/to/repo",
    step="Validating changes before commit",
    findings="Security, completeness, test coverage",
    include_staged=True,
    include_unstaged=False
)

# Review before merge
mcp__pal__codereview(
    review_type="full",
    step="Reviewing feature branch before merge",
    findings="Quality, security, breaking changes",
    compare_to="main"
)

# Consensus on merge conflict resolution
mcp__pal__consensus(
    models=[{"model": "gpt-5.2", "stance": "neutral"}, {"model": "gemini-3-pro", "stance": "neutral"}],
    step="Evaluate: Which conflict resolution preserves intended behavior?"
)

Rube MCP (Automation & Notifications)

Tool When to Use Purpose
mcp__rube__RUBE_SEARCH_TOOLS GitHub/GitLab Find repository management tools
mcp__rube__RUBE_MULTI_EXECUTE_TOOL PR/notifications Create PRs, notify team, update issues
mcp__rube__RUBE_CREATE_UPDATE_RECIPE Git workflows Save reusable git automation

Rube Usage Patterns

# Create PR and notify team after commit
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "GITHUB_CREATE_PULL_REQUEST", "arguments": {
        "repo": "myapp",
        "title": "feat: Add user authentication",
        "body": "## Summary\n- Added JWT auth\n- Added refresh tokens",
        "base": "main",
        "head": "feature/auth"
    }},
    {"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {
        "channel": "#pull-requests",
        "text": "New PR ready for review: feat: Add user authentication"
    }}
])

# Update issue status on merge
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "JIRA_UPDATE_ISSUE", "arguments": {
        "issue_key": "PROJ-123",
        "status": "Done"
    }},
    {"tool_slug": "GITHUB_CREATE_ISSUE_COMMENT", "arguments": {
        "repo": "myapp",
        "issue_number": 456,
        "body": "Merged in PR #789"
    }}
])

Flags (Extended)

Flag Type Default Description
--pal-precommit bool false Use PAL precommit validation
--pal-review bool false Use PAL codereview before merge
--create-pr bool false Create PR via Rube after commit
--notify string - Notify via Rube (slack, teams, email)

Tool Coordination

  • Bash - Git command execution
  • Read - Repository state analysis
  • Grep - Log parsing
  • Write - Commit message generation
  • PAL MCP - Pre-commit validation, code review, conflict resolution
  • Rube MCP - PR creation, team notifications, issue updates
Weekly Installs
1
Installed on
windsurf1
opencode1
codex1
claude-code1
antigravity1
gemini-cli1