branch-management

Creates a feature branch in the BTNet git repository before code edits begin.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/buildertrend/product-toolkit --skill branch-management-buildertrend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-management
Source: https://github.com/buildertrend/product-toolkit/tree/main/frontend-setup/skills/branch-management
Command: npx skills add https://github.com/buildertrend/product-toolkit --skill branch-management-buildertrend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-technical users like designers and PMs risk editing code directly on the main branch, which can break the shared codebase and make changes hard to review. This Skill ensures every change starts in an isolated git branch. ## Core Features & Use Cases - Automatic repo detection: Locates the BTNet project by scanning common folders like home, Desktop, and dev directories, and verifies it by checking for the Clients.App folder. - Branch status check: Detects whether the user is on master/main and pulls the latest changes before branching. - Guided branch naming: Asks for a ticket number and a short description, then sanitizes them into a clean branch name like 231499-update-header-color. - Use Case: A designer wants to tweak a header color. Before any file is edited, this Skill confirms they are on a safe feature branch so the main project stays untouched. ## Quick Start Ask Claude to set up a safe workspace before making changes to the BTNet project.

Frequently Asked Questions about branch-management

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

FAQPage Schema
How do I create a git branch before editing code?

The Skill checks your current branch with git branch --show-current, pulls the latest changes, then runs git checkout -b with a name built from your ticket number and a short description of the change.

How are git branch names generated from a description?

The description is lowercased, spaces become hyphens, invalid characters are removed, and the result is trimmed to 40 characters. If a ticket ID like ado-231499 is provided, its number is prepended, producing names like 231499-update-header-color.

What happens if the BTNet repository cannot be found?

The Skill searches common locations such as the home directory, Desktop, dev, repos, code, Documents, and Downloads folders. If it still cannot find BTNet, it asks the user for the location or directs them to run first-time setup.

What if git pull fails before creating a branch?

A failed pull does not block the workflow. The Skill informs the user they will work from a slightly older copy and continues with branch creation.

Do I need to create a branch if I am already on one?

No. If you are already on any branch other than master or main, the Skill confirms you are working in your own workspace and lets you proceed without creating a new branch.