skills.rest
WU-MAO-CHIA
WU-MAO-CHIACOMMUNITY
Explore all skills by this author →
GitHub

speckit-git-feature

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

Updated May 22, 2026
Search Tags:#git#version control#workflow automation#branch#feature branch#spec-kit#numbering
One-click install
npx skills add https://github.com/WU-MAO-CHIA/AI_tset_platfrom --skill speckit-git-feature-wu-mao-chia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-git-feature
Source: https://github.com/WU-MAO-CHIA/AI_tset_platfrom/tree/main/.opencode/skills/speckit-git-feature
Command: npx skills add https://github.com/WU-MAO-CHIA/AI_tset_platfrom --skill speckit-git-feature-wu-mao-chia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually naming and numbering feature branches in a spec-driven development workflow is error-prone and inconsistent. This Skill automates branch creation with sequential or timestamp-based numbering so every specification gets a predictable, collision-free branch name. ## Core Features & Use Cases - Automated Branch Numbering: Determines the next sequential number or generates a timestamp prefix automatically, without manual tracking. - Short Name Generation: Derives a concise 2-4 word action-noun branch slug from the feature description while preserving technical terms like OAuth2 or JWT. - Configurable Numbering Mode: Reads branch_numbering settings from .specify/extensions/git/git-config.yml or .specify/init-options.json, defaulting to sequential. - Graceful Degradation: Skips branch creation with a warning when Git is unavailable, while still outputting BRANCH_NAME and FEATURE_NUM. - Use Case: While running the /speckit-specify workflow for a new "user authentication" feature, invoke this Skill to create a branch like 003-user-auth and receive structured JSON output for downstream steps. ## Quick Start Create a git feature branch for the new user authentication specification using sequential numbering.

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 in spec-kit?▼

Run the create-new-feature script with a short name and feature description; it automatically determines the next sequential number and outputs JSON containing BRANCH_NAME and FEATURE_NUM. Never pass --number manually, as the script computes it.

How do I switch between sequential and timestamp branch numbering?▼

Set the branch_numbering value in .specify/extensions/git/git-config.yml or .specify/init-options.json. Timestamp mode is invoked with the --timestamp flag and produces names like 20260319-143022-user-auth; otherwise sequential numbering is the default.

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.

What happens if Git is not installed or the directory is not a repository?▼

Branch creation is skipped with the warning '[specify] Warning: Git repository not detected; skipped branch creation'. The script still outputs BRANCH_NAME and FEATURE_NUM so the calling workflow can continue referencing them.

Does this skill create the spec directory and specification files?▼

No, it handles branch creation only. The spec directory and files are created separately by the core /speckit-specify workflow, which consumes the BRANCH_NAME and FEATURE_NUM values from this skill's JSON output.

Related Skills

Explore More Software Engineering Skills→
ApothecaryManApothecaryMan

speckit-git-feature

Generate and switch to numbered Git feature branches in spec-kit projects.

Community
Basic
trungenglishtrungenglish
1

speckit-specify

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

Community
Advanced
wildbitcawildbitca
1

common-git-collaboration

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

Official
Intermediate
joaquimscostajoaquimscosta
21

creating-branch

Create standardized Git feature branches with incrementing names.

Community
Advanced