skills.rest
whw23
whw23COMMUNITY
Explore all skills by this author →
GitHub

speckit-git-feature

Creates numbered git feature branches for spec-kit specification workflows.

Updated May 28, 2026
Search Tags:#git#version control#bash#feature branch#spec-kit#branch creation#powershell
One-click install
npx skills add https://github.com/whw23/PingoGate --skill speckit-git-feature-whw23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/whw23/PingoGate/tree/main/.claude/skills/speckit-git-feature
Command: npx skills add https://github.com/whw23/PingoGate --skill speckit-git-feature-whw23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually naming and numbering feature branches in spec-driven development is error-prone and inconsistent. This Skill automates branch creation with sequential or timestamp-based numbering, keeping branch names aligned with your specification workflow. ## Core Features & Use Cases - Automated Branch Numbering: Determines the next sequential number or generates a timestamp prefix automatically, without manual tracking. - Configurable Naming Strategy: Reads branch numbering configuration from .specify/extensions/git/git-config.yml or .specify/init-options.json, with sensible defaults. - Cross-Platform Scripts: Invokes Bash or PowerShell scripts that output structured JSON containing BRANCH_NAME and FEATURE_NUM. - Graceful Degradation: Skips branch creation with a warning when Git is unavailable, while still returning usable branch identifiers. - Use Case: When starting a new feature specification in a spec-kit project, invoke this Skill to create a branch like 003-user-auth or 20260319-143022-user-auth before writing the spec. ## Quick Start Create a new feature branch for adding OAuth2 user authentication to the project.

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 numbered git feature branch automatically?▼

Run the create-new-feature-branch script with a short name and feature description. The script determines the next sequential number automatically and outputs JSON containing BRANCH_NAME and FEATURE_NUM, such as 003-user-auth.

How to switch between sequential and timestamp branch numbering?▼

Set the branch_numbering value in .specify/extensions/git/git-config.yml, or feature_numbering in .specify/init-options.json. Timestamp mode produces names like 20260319-143022-user-auth; sequential is the default when no configuration exists.

Can I override the generated git branch name?▼

Yes, set the GIT_BRANCH_NAME environment variable before invoking the script. The exact value is used as the branch name, bypassing prefix and suffix generation, and the --short-name, --number, and --timestamp flags are ignored.

Does this work outside a git repository?▼

Branch creation is skipped with a warning when Git is unavailable or the directory is not a repository. The script still outputs BRANCH_NAME and FEATURE_NUM so the calling workflow can reference them.

What are the prerequisites for spec-kit branch creation?▼

The project must follow the spec-kit structure with a .specify directory containing the extension scripts. Git should be installed, and the script must be run only once per feature to avoid duplicate numbering.

Related Skills

Explore More Software Engineering Skills→
nikegeorgian-stacknikegeorgian-stack

speckit-specify

Generate a validated feature specification from a natural language feature description.

Community
Advanced
EpiphyticEpiphytic
7

feature-spec

Create structured product requirements documents with problem statements, goals, and acceptance criteria.

Official
Advanced
wildbitcawildbitca
1

common-git-collaboration

Standardize Git workflows with conventional commits, branch prefixes, and PR checks.

Official
Intermediate
Hand-TomiHand-Tomi

start-issue

Creates Git branches from GitHub issues based on label-derived branch types.

Community
Intermediate