create-branch

Creates Git/non-Git feature branches and outputs BRANCH_NAME, SPEC_FILE, FEATURE_DIR.

52|3|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/ZTE-AICloud/Co-OmniSpec --skill create-branch-zte-aicloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-branch
Source: https://github.com/ZTE-AICloud/Co-OmniSpec/tree/main/skills/create-branch
Command: npx skills add https://github.com/ZTE-AICloud/Co-OmniSpec --skill create-branch-zte-aicloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the decision and creation or reuse of Git/Non-Git branches and feature directories, and outputs BRANCH_NAME, SPEC_FILE, and FEATURE_DIR to support your spec-driven workflow.

Core Features & Use Cases

  • Determine whether to create, switch, or reuse branches based on BRANCH_NAME and FEATURE_DIR inputs.
  • Create or reuse changes/ feature directories and ensure spec.md exists.
  • Output BRANCH_NAME, SPEC_FILE, and FEATURE_DIR for downstream activation.

Quick Start

Provide BRANCH_NAME and/or FEATURE_DIR to create or reuse a feature branch and its directory, returning BRANCH_NAME, SPEC_FILE, and FEATURE_DIR for downstream steps.

Frequently Asked Questions about create-branch

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

FAQPage Schema
How do I automate feature branch creation and manage the feature directory in a Git workflow?

Automating feature branch creation determines whether to create, switch, or reuse Git branches while normalizing the feature directory and ensuring spec.md exists. It outputs the final branch name, spec file, and feature directory for downstream steps.

How do I create a feature branch and set up changes directory for non-Git workspaces?

Creating a feature branch for non-Git workspaces reuses or establishes the branch logic and normalizes the feature directory to changes/<dir>. It ensures spec.md exists and returns the branch name, spec file, and feature directory for subsequent workflow tasks.

What is the best way to normalize feature directory paths and ensure spec.md exists for spec-driven development?

Normalizing feature directory paths standardizes the location to changes/<dir> and verifies that spec.md is present. This process outputs the final branch name, spec file path, and normalized feature directory to support spec-driven development workflows.

Can I use inferred descriptions to create a Git feature branch instead of providing explicit branch names?

Yes, creating a Git feature branch applies to both explicit inputs and inferred descriptions. It processes the provided context to decide the branch action, normalizes the feature directory, and outputs the branch name, spec file, and feature directory.

Do I need an existing Git repository to create feature branches and changes directories?

No, you do not need an existing Git repository as this process applies to both Git and non-Git workspaces. It decides the branch action, normalizes the feature directory, ensures spec.md exists, and outputs the branch name and file paths.

Why does my spec-driven workflow require a normalized changes directory and spec.md file?

A spec-driven workflow requires a normalized changes directory and spec.md file to maintain consistent feature tracking. The process normalizes the directory to changes/<dir>, validates spec.md existence, and outputs these paths for downstream activation.