git

by @bntvllnt in AI & LLM

# Install this skill:

npx skills add bntvllnt/agent-skills --skill "git"

Install specific skill from multi-skill repository

# Description

# SKILL.md

name: git
description: |
Unified git workflow for branch-first development: status/diff review, security-first commits,
worktrees, and PR creation/review via gh.
Auto-activates on: "commit", "push", "branch", "worktree", "pr", "pull request", "merge", "rebase", "git".
license: MIT
compatibility: Requires git. PR workflows may use GitHub + gh CLI (optional). Worktree workflows create local directories under WORKTREES_DIR.
metadata:
version: "1.0"

Git

Clear, repeatable git workflow with a bias toward safety.

Router

Use the smallest workflow that matches the user intent.

User says	Load reference	Do
status / what changed	`references/read-only.md`	read-only inspection
help / usage / man	`references/cli-help.md`	show CLI help safely
commit / stage	`references/commit-workflow.md`	stage + commit safely
branch / switch	`references/branch-workflow.md`	branch operations
worktree create/remove/list	`references/worktree-workflow.md`	worktree operations
worktree cleanup / normalize / consolidate	`references/worktree-maintenance.md`	auto-clean + consolidate worktrees
tag / version	`references/tag-workflow.md`	create/list/inspect tags
pr / pull request	`references/pr-workflow.md`	create/update PR via gh
pr review / fix pr comments / threads	`references/pr-review-workflow.md`	review + respond + fix
merge / rebase / reset / revert	`references/advanced-workflows.md`	advanced/recovery (confirm first)

Config (Edit Here)

Worktree working directories (the folders you cd into) live outside .git/.

Set this once and use it everywhere:

WORKTREES_DIR=./.worktrees
WORKTREE_PATH=$WORKTREES_DIR/<topic>

If you want a different location (e.g. ../.worktrees or ~/worktrees/<repo>), update WORKTREES_DIR above and follow the same shape in references/worktree-workflow.md.

Resilience Rules (Worktrees)

If multiple worktree root folders are detected (example: both ./.worktrees/ and ../repo-feature-x/ exist), do not delete anything by default.
Prefer consolidating into WORKTREES_DIR using git worktree move (when possible) or a remove+re-add plan.
If stale metadata exists, propose a cleanup plan: git worktree prune + remove/quarantine orphan directories (with confirmation).

Global Safety Rules (Never Violate)

Never force push to main/master.
Never commit secrets (env files, keys, credentials).
Never rewrite history that is already pushed unless explicitly requested.
Always show what will change before an irreversible action.

Confirmation Policy

Read-only commands are always OK.

Everything that changes state/history/remote requires explicit user confirmation:
- git add, git commit, git push
- git merge, git rebase, git reset, git revert
- git worktree add, git worktree remove
- git tag (create/delete)
- git branch -d/-D

Quick Start

# Read-only
git status
git diff

# Commit
git diff --cached
git commit -m "feat(scope): why"

# Worktrees
git worktree list

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.

git