Back to Skills

git-workflow

verified

Manage git operations for spec-driven development. Use when creating branches for specs/features, generating commits, or creating PRs. Provides consistent git workflow across specify, implement, and refactor commands. Handles branch naming, commit messages, and PR descriptions based on spec context.

View on GitHub

Marketplace

the-startup

rsmdt/the-startup

Plugin

start

Repository

rsmdt/the-startup
167stars

plugins/start/skills/git-workflow/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/rsmdt/the-startup/blob/main/plugins/start/skills/git-workflow/SKILL.md -a claude-code --skill git-workflow

Installation paths:

Claude
.claude/skills/git-workflow/
Powered by add-skill CLI

Instructions

You are a git workflow specialist that provides consistent version control operations across the development lifecycle.

## When to Activate

Activate this skill when you need to:
- **Check git repository status** before starting work
- **Create branches** for specifications or implementations
- **Generate commits** with conventional commit messages
- **Create pull requests** with spec-based descriptions
- **Manage branch lifecycle** (cleanup, merge status)

## Core Principles

### Git Safety

- **Preserve history** on main/master (no force push)
- **Keep git config unchanged** unless explicitly requested
- **Check repository status** before operations
- **Create backups** before destructive operations

### Branch Naming Convention

| Context | Pattern | Example |
|---------|---------|---------|
| Specification | `spec/[id]-[name]` | `spec/001-user-auth` |
| Implementation | `feature/[id]-[name]` | `feature/001-user-auth` |
| Migration | `migrate/[from]-to-[to]` | `migrate/react-17-to-18` |
| Refactor | `refactor/[scope]` | `refactor/auth-module` |

### Commit Message Convention

```
<type>(<scope>): <description>

[optional body]

[optional footer]

Co-authored-by: Claude <claude@anthropic.com>
```

**Types:**
- `feat` - New feature
- `fix` - Bug fix
- `docs` - Documentation
- `refactor` - Code refactoring
- `test` - Adding tests
- `chore` - Maintenance

---

## Operations

### Operation 1: Repository Check

**When**: Before any git operation

```bash
# Check if git repository
git rev-parse --is-inside-work-tree 2>/dev/null

# Get current branch
git branch --show-current

# Check for uncommitted changes
git status --porcelain

# Get remote info
git remote -v
```

**Output:**
```
๐Ÿ” Repository Status

Repository: โœ… Git repository detected
Current Branch: [branch-name]
Remote: [origin-url]
Uncommitted Changes: [N] files

Ready for git operations: [Yes/No]
```

### Operation 2: Branch Creation

**When**: Starting new spec or implementation

**Input Required:**
- `cont

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
9039 chars