speckit-git-feature

Create and checkout a Git feature branch with configured numbering.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Mohsen3-5/Trader --skill speckit-git-feature-mohsen3-5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/Mohsen3-5/Trader/tree/main/Trader/.claude/skills/speckit-git-feature
Command: npx skills add https://github.com/Mohsen3-5/Trader --skill speckit-git-feature-mohsen3-5

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It automates the creation of a new Git feature branch (and switches to it) using a spec’s feature description, so you don’t have to manually decide branch names or next numbers.

Core Features & Use Cases

  • Feature branch creation & checkout: Generates and switches to a new feature branch for a given specification, leaving the spec directory work to the core workflow.
  • Sequential or timestamp numbering: Chooses numbering mode from .specify/extensions/git/git-config.yml, falls back to .specify/init-options.json, otherwise defaults to sequential.
  • Deterministic script invocation: Runs exactly one platform-appropriate script (Bash or PowerShell) and consumes JSON output containing BRANCH_NAME and FEATURE_NUM.
  • Environment override support: If GIT_BRANCH_NAME is explicitly provided, it uses that exact value and bypasses generated prefix/suffix logic.

Quick Start

Ask the skill to create and switch to a new feature branch for your provided feature description using the repository’s configured branch numbering mode.

Frequently Asked Questions about speckit-git-feature

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

FAQPage Schema
How do I automatically create a numbered Git feature branch from a spec description?

To create a numbered Git feature branch from a spec description, this automation reads your repository's branch configuration and runs a script to generate a sequentially or timestamp-numbered branch name, then checks it out and returns the branch name and feature number as JSON.

Can I override the generated Git branch name with a custom value?

Yes, you can override the generated Git branch name by explicitly providing a GIT_BRANCH_NAME value in your environment, which bypasses the standard prefix and suffix logic to use your exact string.

How does branch numbering work when creating feature branches for spec-kit workflows?

Branch numbering for spec-kit workflows checks the .specify/extensions/git/git-config.yml file first, falls back to .specify/init-options.json, and defaults to sequential numbering if neither configuration exists.

Does this feature branch creation script support both Bash and PowerShell?

Yes, the feature branch creation script supports both Bash and PowerShell by invoking exactly one platform-appropriate script to parse the specification and output the required JSON data.

What JSON output does the automated Git feature branch creation process return?

The automated Git feature branch creation process returns JSON output containing BRANCH_NAME and FEATURE_NUM variables, which can be consumed by downstream spec-kit workflow processes for tracking incremental development tasks.