Ensures clean, standardized git history for GSD-based projects through structured commit and branching patterns.

Install

mkdir -p .claude/skills/gsd-git && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/9659" && unzip -o skill.zip -d .claude/skills/gsd-git && rm skill.zip

Installs to .claude/skills/gsd-git

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Patterns and guidelines for git operations within the GSD framework.
68 charsno explicit “when” trigger
Beginner

Key capabilities

  • Phase-specific branching
  • Commit message formatting
  • Repository handoff management

How it works

Enforces specific naming conventions and branching strategies based on project milestones.

Inputs & outputs

You give it
Project phase/task
You get back
Formatted git commit/branch

When to use gsd-git

  • Create phase-specific git branch
  • Format feature commit messages
  • Perform repository handoff

About this skill

GSD Git Skill

Follow these patterns for all git operations to ensure a clean, outcome-oriented history.

Commit Points

  • Initialization: Commit PROJECT.md and initial planning docs.
  • Tasks: Commit each task immediately after completion.
  • Plan Completion: Metadata commit for SUMMARY.md, STATE.md, and ROADMAP.md.
  • Handoff: wip: commit when pausing mid-phase.

Commit Formats

  • feat({phase}-{plan}): {description}
  • fix({phase}-{plan}): {description}
  • test({phase}-{plan}): {description}
  • refactor({phase}-{plan}): {description}
  • docs({phase}-{plan}): {description}

Branching Strategies

  • None: Commit directly to the current branch.
  • Phase: Create a branch per phase (gsd/phase-{N}-{slug}).
  • Milestone: Create a branch per milestone (gsd/{version}-{slug}).

When not to use it

  • General git operations outside GSD framework
  • Non-project-based git tasks

Prerequisites

Git installed

Limitations

  • Strict adherence to GSD framework required

How it compares

Standardizes history for outcome-oriented tracking instead of generic commit messages.

Compared to similar skills

gsd-git side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gsd-git (this skill)06moNo flagsBeginner
resolve-conflicts818moReviewIntermediate
dependency-upgrade265moReviewIntermediate
openspec-onboard106moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry