speckit-git-feature

Create and switch to a numbered git feature branch from a specification.

Updated Apr 26, 2026

Search Tags:#automation #git #workflow #branch #naming #version-control #feature-branch

Ready to run

npx skills add https://github.com/victorevh/orbitarium-engine-sdd --skill speckit-git-feature-victorevh

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/victorevh/orbitarium-engine-sdd/tree/main/.cursor/skills/speckit-git-feature
Command: npx skills add https://github.com/victorevh/orbitarium-engine-sdd --skill speckit-git-feature-victorevh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create and switch to a new git feature branch for the given specification. This command handles branch creation only — the spec directory and files are created by the core speckit.specify workflow.

Core Features & Use Cases

Deterministic naming: generate a meaningful short name from the feature description.
Branching modes: supports sequential or timestamp-based numbering based on configuration.
Graceful handling: detects missing Git or non-repository context and continues with safe defaults.

Quick Start

Create and switch to a new git feature branch using the provided feature description.

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 git feature branch from a feature description?▼

You can automatically create a git feature branch by providing a feature description to generate a deterministic short name. The tool validates your Git environment, creates the branch, and switches to it automatically.

Can I use a timestamp instead of sequential numbers for feature branch naming?▼

Yes, you can configure feature branch naming to use either sequential or timestamp-based numbering. This ensures deterministic branch names while adapting to your preferred version control workflow.

What happens if I try to create a feature branch outside a Git repository?▼

If you run this outside a Git repository, the tool detects the missing repository context and continues with safe defaults instead of failing. It gracefully handles missing Git availability without interrupting your workflow.

How do I override the automatic feature branch name generation in version control?▼

You can override the automatic feature branch name generation by providing an explicit GIT_BRANCH_NAME variable. This bypasses the deterministic naming logic and sequential numbering, enforcing your custom branch name.

Does this branching tool output variables for downstream automation?▼

Yes, the tool outputs BRANCH_NAME and FEATURE_NUM in JSON format specifically for downstream tooling. This allows your automation pipelines to capture the exact branch name and feature number for subsequent workflow steps.

When do I need to automate feature branch creation in my workflow?▼

You need to automate feature branch creation when you want consistent naming conventions across your version control workflow. It solves the problem of manual naming errors by generating deterministic short names directly from feature specifications.