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.