Skip to content

EmanuProds/dotfiles / skills/git-workflow

git-workflow"

Unverified

Git workflow automation including conventional commits, branch management, PR creation, and release tagging. Use when working with git repositories for commit, push, PR, or release tasks.

Git Workflow Skill

Conventional Commits

Format: <type>(<scope>): <subject>

Types

  • feat - New feature
  • fix - Bug fix
  • docs - Documentation only
  • style - Formatting, no logic change
  • refactor - Code restructuring
  • perf - Performance improvement
  • test - Adding tests
  • chore - Maintenance, deps, build
  • ci - CI/CD changes

Examples

feat(auth): add OAuth2 login flow
fix(api): handle null response in user endpoint
refactor(db): extract query builder class

Branch Strategy

main                    # Production releases
├── develop             # Integration branch
├── feature/*           # New features
├── fix/*               # Bug fixes
├── release/*           # Release preparation
└── hotfix/*            # Production patches

Common Commands

Start Work

git checkout develop && git pull
git checkout -b feature/your-feature-name

Commit with Conventional Format

git add -A
git commit -m "feat(scope): description"

Push & Create PR

git push -u origin feature/your-feature-name
gh pr create --base develop --title "feat(scope): description" --body "## Changes\n- ...\n\n## Testing\n- ..."

Sync with Develop

git fetch origin
git rebase origin/develop
# resolve conflicts if any
git push --force-with-lease

Release

git checkout main && git pull
git merge --no-ff release/v1.2.3
git tag -a v1.2.3 -m "Release v1.2.3"
git push origin main --tags

GitHub CLI Integration

# View PR
gh pr view 123 --json title,body,files,reviews

# Review PR
gh pr review 123 --approve --body "LGTM"

# Merge PR
gh pr merge 123 --squash --delete-branch

# List workflow runs
gh run list --workflow=ci.yml --limit=10

Automation Hooks

Add to .git/hooks/prepare-commit-msg:

#!/bin/bash
# Auto-prefix with branch name if feature/fix branch
BRANCH=$(git symbolic-ref --short HEAD)
if [[ $BRANCH =~ ^(feature|fix|hotfix)/(.+) ]]; then
  PREFIX="${BASH_REMATCH[1]}(${BASH_REMATCH[2]}): "
  sed -i "1s/^/$PREFIX/" "$1"
fi

When to Use

  • Creating commits with proper format
  • Managing feature branches
  • Creating and reviewing PRs
  • Preparing releases
  • Automating git workflows
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 117kUpdated Claude CodeCodexUnverifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 107kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 107kUpdated Claude CodeCodexVerifiedInstall