GitHub CLI & Git Workflow Skills

Overview

Skills

gh-cli Skill

git-commit-push Skill

# ✅ CORRECT: Specify files explicitly
git add src/file1.ts src/file2.ts

# ❌ WRONG: Adds all files including temporaries
git add -A && git commit -m "..."

# ✅ CORRECT: Check before committing
git status
git diff --cached

# ✅ CORRECT: Multi-line commit messages via file
git commit --file=<workspace_dir>/temp/git-commit-msg.txt

# ✅ CORRECT: Update feature branch with rebase (clean history)
git checkout master && git pull origin master
git checkout feature/your-branch && git rebase master

# ✅ CORRECT: Push only after user approval
# Ask user before any push operation

code-review Skill

Repository Structure

skills/
├── gh-cli/                     # GitHub CLI reference skill
│   ├── SKILL.md                # Navigation hub
│   └── references/             # 13 modular reference documents
│       ├── auth.md
│       ├── repo.md
│       ├── issues.md
│       ├── prs.md              # Pull request workflows ⚠️ Critical warnings
│       ├── pr-reviews.md       # PR Reviews extension - Inline code review
│       ├── actions.md
│       ├── projects.md
│       ├── releases.md
│       ├── gists.md
│       ├── codespaces.md
│       ├── search.md
│       ├── advanced.md
│       └── config.md
├── git-commit-push/            # Git workflow guidelines skill
│   └── SKILL.md                # Commit/push best practices
└── code-review/                # Code review framework skill
    └── SKILL.md                # 8-step review methodology

Installation

For AI Agents

# Install specific skills
npx skills add https://github.com/WhizZest/agent-git-skills --skill gh-cli
npx skills add https://github.com/WhizZest/agent-git-skills --skill git-commit-push
npx skills add https://github.com/WhizZest/agent-git-skills --skill code-review

# Or install all skills at once
npx skills add https://github.com/WhizZest/agent-git-skills

# Or manually copy the skill directories to your agent's skills directory
# Or use symbolic links to keep them in sync with the repo
# (Both methods require cloning this repository first)

Prerequisites

GitHub CLI (for gh-cli skill)

# macOS
brew install gh

# Linux
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh

# Windows
winget install --id GitHub.cli

# Verify installation
gh --version

Git (for git-commit-push skill)

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Quick Start

Using gh-cli Skill

Authentication

gh auth login
gh auth status

Repository Operations

gh repo create my-project --public --description "My awesome project"
gh repo clone owner/repo
gh repo view --web

Issue & PR Management

gh issue list
gh issue create --title "Bug report" --body-file workspace_dir/temp/issue-body.md
gh pr list
gh pr create --title "Fix bug" --body-file workspace_dir/temp/pr-body.md

Using git-commit-push Skill

Critical Best Practices

⚠️ Always Use --body-file for PR/Issue Content

# ✅ CORRECT, workspace_dir is the workspace root (top-level directory containing all repositories). Exception: if workspace itself is a repository root, use that directory.
gh pr create --title "Feature" --body-file workspace_dir/temp/description.md

# ❌ WRONG - backticks cause escaping issues
gh pr create --title "Feature" --body "Use \`code()\` function..."

⚠️ Export PR Content to Files Before Viewing

# ✅ CORRECT workflow, workspace_dir is the workspace root (top-level directory containing all repositories). Exception: if workspace itself is a repository root, use that directory.
gh pr view 123 --comments > workspace_dir/temp/pr-123.md
cat workspace_dir/temp/pr-123.md

# ❌ WRONG (may lose data)
gh pr view 123 --comments

Usage Examples

Daily Development Workflow

# Check your open PRs
gh pr list --author @me

# Check recent issues assigned to you
gh issue list --assignee @me

# View notifications
gh api notifications

# Create a release
gh release create v1.0.0 --title "Version 1.0.0" --notes "Release notes"

Project Management

# List projects
gh project list

# Add item to project
gh project item-add 123 --url https://github.com/org/repo/issues/456

# Update item status
gh project item-edit --id ITEM_ID --status-field-id FIELD_ID --single-select-option-id OPTION_ID

How the Skills Work Together

Topics

Version

Contributing

License

Resources