new-branch

Creates and publishes a categorized git branch from a description, ticket link, or current changes.

Updated Jul 11, 2026
One-click install
npx skills add https://github.com/danielsuguimoto/skills --skill new-branch-danielsuguimoto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: new-branch
Source: https://github.com/danielsuguimoto/skills/tree/main/skills/new-branch
Command: npx skills add https://github.com/danielsuguimoto/skills --skill new-branch-danielsuguimoto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting new work often means manually inspecting uncommitted changes, picking a branch naming convention, and running several git commands. This Skill automates that flow by deriving a categorized branch name from a description, ticket/issue link, or your current uncommitted and ahead-of-base work, then creating and publishing the branch. ## Core Features & Use Cases - Argument-driven branching: Accepts a free-form description or a ticket/issue link (GitHub, Linear, Jira) and derives the branch category and slug from it. - Change-aware naming: With no argument, it analyzes uncommitted changes and ahead-of-base commits to infer a category (feature, fix, refactor, docs, test, chore, perf, build, ci) and a kebab-case slug. - Safety checks and publishing: Blocks when there is nothing to branch from or when already on a work branch, pulls the latest remote state, creates the branch, and pushes it with upstream tracking. - Use Case: You paste a Linear ticket link and say "start a branch for this" — the Skill reads the ticket, infers the category, and creates and pushes something like feature/add-oauth-login. ## Quick Start Ask the agent to create a new branch from your ticket link or current uncommitted changes, for example: "Start a new branch for this work."

Frequently Asked Questions about new-branch

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

FAQPage Schema
How do I create a git branch from a ticket or issue link?▼

Provide the ticket or issue URL (GitHub, Linear, Jira) as the argument. The Skill extracts the ticket title, summary, and labels via the issue tracker tools, infers a category, and creates a branch like fix/login-timeout from it.

How do I create a branch from uncommitted changes?▼

Invoke the Skill with no argument. It scans uncommitted changes and commits ahead of the base branch, groups them into themes, and derives a category and kebab-case slug for the new branch name.

What branch naming categories does it support?▼

It supports feature, fix, refactor, docs, test, chore, perf, build, and ci categories. The category is inferred from ticket labels, the description argument, or the analyzed change summary, followed by a 2-4 word kebab-case slug.

Why does branch creation stop with 'Nothing to branch from'?▼

That stop occurs when no argument is given and there are no uncommitted changes or ahead-of-base commits to derive a name from. Provide a description or ticket link, or make changes first, then retry.

Can I create a new branch while already on a work branch?▼

No. If the current branch already starts with a work prefix like feature/, fix/, or refactor/, the Skill stops and reports that branching is skipped. Switch back to a base branch before invoking it.