Agent-Skills.md

Agent Skills: Git Skill (Smart Commit Workflow)

Git integration with LangGraph workflow support, Smart Commit V2, and Spec-Awareness

UncategorizedID: tao3k/omni-dev-fusion/git

Repository

tao3k/omni-dev-fusion
tao3kLicense: Apache-2.0
7

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tao3k/omni-dev-fusion/tree/HEAD/assets/skills/git

Skill Files

Browse the full folder contents for git.

Download Skill

Loading file tree…

assets/skills/git/SKILL.md

Skill Metadata

Name
git
Description
Use when committing code, managing branches, pushing to remote, creating pull requests, or performing version control operations. Conforms to docs/reference/skill-routing-value-standard.md.

Git Skill (Smart Commit Workflow)

Code is Mechanism, Prompt is Policy

Smart Commit Workflow (Primary Query Anchor)

smart commit is the canonical query phrase for this skill. Use git.smart_commit to run the full smart commit workflow (stage -> scan -> approve -> commit).

Architecture

This skill uses @skill_command decorator in scripts/*.py files. Commands are automatically exposed via MCP as git.command_name.

Available Commands

| Command | Description | | ------------------ | ------------------------------------------------------- | | git.status | Show working tree status | | git.stage_all | Stage all changes (with security scan) | | git.commit | Commit staged changes | | git.smart_commit | Smart Commit workflow (stage → scan → approve → commit) | | git.push | Push to remote | | git.log | Show commit logs |

Smart Commit Workflow

Use git.smart_commit for secure, human-in-the-loop commits:

# Step 1: Start workflow
git.smart_commit(action="start")
# Returns workflow_id and diff preview

# Step 2: After LLM analysis and user approval
git.smart_commit(action="approve", workflow_id="xxx", message="feat: description")

Flow: stage_and_scan → route_prepare → format_review → re_stage → interrupt → commit

Linked Notes

Staged Files Feature

Stage and Scan Workflow

The stage_and_scan function provides automatic staging with security validation:

Stage All Files → Security Scan → Lefthook Pre-commit → Finalize

Key Features

  1. Automatic Staging

    stage_and_scan(project_root=".")
# Returns: {staged_files, diff, security_issues, lefthook_error}

  2. Security Scanning

    • Detects sensitive files (.env*, *.pem, *.key, *.secret, etc.)
    • Automatically un-stages detected files
    • Returns list of security issues

  3. Lefthook Integration

    • Runs pre-commit hooks after staging
    • Re-stages files modified by lefthook formatters
    • Returns lefthook output for review

Staged Files Commands

| Command | Description | | ----------------- | ----------------------------------------- | | git.stage_all() | Stage all changes with security scan | | git.status() | Show staged files and working tree status | | git.diff() | Show staged diff |

Security Patterns Detected

.env*, *.env*, *.pem, *.key, *.secret, *.credentials*
id_rsa*, id_ed25519*, *.priv
secrets.yml, secrets.yaml, credentials.yml

Usage Guidelines

Read Operations (Safe - Use Claude-native bash)

git status
git diff --cached
git diff
git log --oneline

Write Operations (Use MCP Tools)

| Operation | Tool | | ------------ | ------------------------------------- | | Stage all | git.stage_all() (scans for secrets) | | Commit | git.commit(message="...") | | Push | git.push() | | Smart Commit | git.smart_commit(action="start") |

Key Principle

Read = Claude-native bash. Write = MCP tools.