speckit-git-feature

Create and switch to standardized git feature branches from specifications.

Updated May 28, 2026
One-click install
npx skills add https://github.com/bdunnette/reaper --skill speckit-git-feature-bdunnette
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/bdunnette/reaper/tree/main/.agents/skills/speckit-git-feature
Command: npx skills add https://github.com/bdunnette/reaper --skill speckit-git-feature-bdunnette

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create and switch to a new git feature branch for the given specification; this command handles branch creation only — the spec directory and files are created by the core /speckit-specify workflow.

Core Features & Use Cases

  • Generates a feature branch named from the specification with either sequential or timestamp-based numbering.
  • Supports environment variable overrides to customize the branch name.
  • Gracefully handles missing Git by warning and skipping branch creation; suitable for non-Git workflows.

Quick Start

Provide a feature specification and optionally set GIT_BRANCH_NAME to override the generated branch, then run the speckit git feature command to create and switch to the new branch.

Frequently Asked Questions about speckit-git-feature

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

FAQPage Schema
How do I automate git feature branch creation for a specification?

Automate git feature branch creation by running a command that generates a branch named from your specification with sequential or timestamp-based numbering, then switches to it automatically. This ensures consistent naming across multiple specs.

Can I override the generated git feature branch name?

Yes, you can override the generated git feature branch name by setting the GIT_BRANCH_NAME environment variable before running the command, allowing you to customize branch naming outside the default sequential numbering.

What happens if Git is not installed when creating a feature branch?

If Git is not available, the workflow gracefully handles the missing dependency by warning the user and skipping branch creation, making it suitable for non-Git workflows that still require specification tracking.

Does the speckit git feature command create the spec directory and files?

No, the speckit git feature command handles branch creation only. The spec directory and files must be created beforehand by the core speckit-specify workflow before you switch to the new branch.

How does sequential branch numbering work for feature tracking?

Sequential branch numbering assigns incremental numbers to each new feature branch tied to a specification, ensuring reproducible feature tracking across multiple specs and maintaining consistent naming conventions throughout the workflow.