git-workflow

Automates branching, committing, rebasing, and pull request creation using git and the gh CLI.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/OktayCopurlu/ai-shared --skill git-workflow-oktaycopurlu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/OktayCopurlu/ai-shared/tree/main/.github/workflows/skills/git-workflow
Command: npx skills add https://github.com/OktayCopurlu/ai-shared --skill git-workflow-oktaycopurlu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Moving code from local changes to a reviewed pull request involves many error-prone steps: naming branches to match tickets, running lint and type checks, writing clean commits, and drafting reviewer-friendly PR bodies. This Skill standardizes that entire pipeline so nothing gets skipped. ## Core Features & Use Cases - Branch and Commit Discipline: Enforces ticket-keyed branch names, staged-file scoping, and imperative commit messages without AI attribution trailers. - Pre-commit Quality Gates: Runs lint, formatters, type checks, and tests on changed files before any commit is allowed. - Structured PR Creation: Uses the gh CLI to create PRs with a four-section body contract (Description, Verification, Test Instructions, Note), assigns reviewers, and requests Copilot review. - Use Case: After finishing a bug fix on branch DSC-1986-fix-rails-sticky, ask the agent to run the full workflow — it lints and tests the changed files, commits only relevant changes, and opens a PR with before/after reproduction evidence and a Jira link. ## Quick Start Create a branch for ticket DSC-1986, commit my staged changes after running lint and type checks, and open a pull request with test instructions.

Frequently Asked Questions about git-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a pull request with the gh CLI?▼

Use gh pr create to open the pull request, then gh pr edit --add-assignee to assign a reviewer. The workflow derives the PR title from the branch name and structures the body with Description, Verification, Test Instructions, and Note sections.

How should I name git branches for Jira tickets?▼

Use the format <TICKET>-<description>, for example DSC-1986-fix-rails-sticky. Branch from an up-to-date main by running git checkout main, git pull origin main, then git checkout -b with the new branch name.

What checks should run before committing code?▼

Run the repo's lint fix command or formatter on changed files, then lint, type checks, and related tests for the affected package. Only commit after all checks pass on your changes, and never skip them with --no-verify except as an explicit last resort.

What should a good PR description include?▼

Include a one-to-two sentence Description, an optional Verification section with before/after evidence for UI changes or bug fixes, Test Instructions with concrete preview and design links, and an optional Note for caveats. Avoid file-by-file changelogs and local test commands.

When should I not use this git workflow skill?▼

Do not use it for GitHub API operations like listing issues, searching code, or reading PR reviews — those belong to a GitHub MCP or API skill. It also should not create a PR when the diff is empty or the branch name does not match the ticket key.