speckit-git-feature

Create a Git feature branch with sequential or timestamp numbering from Spec-Kit configuration.

60|12|Updated Aug 1, 2013
One-click install
npx skills add https://github.com/vtex/front.phone --skill speckit-git-feature-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/vtex/front.phone/tree/main/.agents/skills/speckit-git-feature
Command: npx skills add https://github.com/vtex/front.phone --skill speckit-git-feature-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It automates the creation of a new Git feature branch with a consistent numbering scheme, so you can start work immediately without manually deciding branch names.

Core Features & Use Cases

  • Create and switch to a feature branch: Handles only branch creation (spec files are created elsewhere by the core workflow).
  • Sequential or timestamp numbering: Chooses numbering strategy from your .specify Git configuration or init options, then generates the next branch identifier automatically.
  • Environment override support: If GIT_BRANCH_NAME is provided, it uses the exact branch name and bypasses generated prefix/suffix logic.

Quick Start

Use the speckit-git-feature skill with your feature description to generate and switch 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 Git feature branch with automatic sequential numbering?

To create a Git feature branch with sequential numbering, this skill reads your Spec-Kit configuration to determine the numbering strategy and generates the next branch identifier. It then creates the branch and immediately switches to it.

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

Yes, you can override the generated Git branch name by setting the GIT_BRANCH_NAME environment variable. When provided, the skill uses this exact name and bypasses the generated prefix and suffix logic from your configuration.

What is the difference between sequential and timestamp branch numbering in Spec-Kit?

Sequential branch numbering increments a deterministic counter for each new feature branch, while timestamp numbering uses the current time. The skill selects which strategy to use by reading your .specify Git configuration or init options.

Does this branch creation skill work on both Windows and Unix platforms?

Yes, the skill works across platforms by selecting and running the correct platform-specific create-new-feature script. It validates that Git is available on your system before executing the branch creation script exactly once.

Do I need to manually create specification files before using this feature workflow?

No, you do not need to manually create specification files with this skill because it handles only branch creation and switching. The core workflow creates the spec files elsewhere, while this skill focuses on deterministic branch naming.