branch

Create a new git branch from an up-to-date base branch with validation.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/lukeylias/lukeydev --skill branch-lukeylias
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch
Source: https://github.com/lukeylias/lukeydev/tree/main/skills/branch
Command: npx skills add https://github.com/lukeylias/lukeydev --skill branch-lukeylias

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the guesswork and risk from creating a new git branch by first syncing from the correct base branch and enforcing a clean starting state.

Core Features & Use Cases

  • Base Branch Detection: Identifies the repository's default branch and switches to an up-to-date starting point before branching.
  • Safe Branch Creation: Checks for modified tracked files, validates branch naming, and stops when the workspace is unsafe.
  • Work and Personal Workflows: Handles ticket-based branch conventions in work repositories and type-prefixed names for personal projects.

Quick Start

Ask the branch skill to create a new branch for your current task after syncing from the latest base branch.

Frequently Asked Questions about branch

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

FAQPage Schema
How do I create a new git branch from an up-to-date base branch safely?

To create a git branch safely, the workspace must first synchronize with the default base branch and validate that the working tree is clean before checking out the new branch.

What happens if I try branching with modified tracked files in my repository?

Branching with modified tracked files triggers safe failure handling. The process stops and prevents creating a new git branch until the repository working tree is completely clean.

Can I use different branch naming conventions for work and personal repositories?

Yes, branch creation supports both work and personal workflows. It formats ticket-based branch naming conventions for work repositories and applies type-prefixed names for personal projects.

How does base branch detection work when synchronizing a repository?

Base branch detection works by identifying the repository's default branch. It switches to that detected starting point and pulls the latest updates before attempting any new branch creation.

Why does git branch creation fail when pull or checkout conditions are not met?

Git branch creation fails because built-in validation checks stop the process when pull or checkout conditions are unmet, ensuring workspace safety and preventing inconsistent branch states.