speckit-git-feature

Create and switch to a sequentially or timestamp-numbered Git feature branch.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Congtrinhh/sholy-be --skill speckit-git-feature-congtrinhh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/Congtrinhh/sholy-be/tree/main/.agents/skills/speckit-git-feature
Command: npx skills add https://github.com/Congtrinhh/sholy-be --skill speckit-git-feature-congtrinhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of creating a consistent, correctly numbered Git feature branch for a specification without manually choosing the next available branch name.

Core Features & Use Cases

  • Feature branch creation and switching: Creates a new feature branch and switches your working context to it, while leaving spec directory creation to the core workflow.
  • Sequential or timestamp numbering: Chooses the numbering strategy from configuration (or defaults to sequential) and generates the branch name accordingly.
  • Environment override via GIT_BRANCH_NAME: When you provide GIT_BRANCH_NAME, it passes that exact value through as the branch name while applying internal parsing rules for FEATURE_NUM.
  • Graceful handling when Git is unavailable: Detects whether you are inside a Git work tree and skips branch creation with a warning if not.

Quick Start

Run the speckit-git-feature skill with your feature description so it creates and switches to the next correctly numbered feature 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 create a feature branch with sequential numbering in Git?

To create a sequentially numbered feature branch, the skill applies configuration-driven numbering selection to generate a consistent branch name and switches your Git context to it automatically.

Can I override the generated Git feature branch name manually?

Yes, you can override Git feature branch naming by passing the GIT_BRANCH_NAME variable, which outputs your exact value while still applying internal parsing rules for FEATURE_NUM.

What happens if I run branch creation outside a Git work tree?

When Git is unavailable or you are outside a Git work tree, the skill detects this environment and gracefully skips branch creation with a warning instead of failing.

Does the skill support timestamp-based numbering for feature branches?

Yes, the skill supports timestamp-based branch numbering by selecting the numbering strategy from your configuration, defaulting to sequential numbering if no preference is specified.

How do I initialize a consistent feature branch workflow for spec development?

To initialize a feature workflow, run the skill with your feature description to execute the underlying script exactly once, parsing JSON output to create and switch to the numbered branch.

What is the best way to avoid manually choosing the next available Git branch name?

The best way to avoid manual branch naming is using this skill, which automatically determines the next available sequential or timestamp-based number for your specification feature branch.