branch-creation

Create feature branches from the latest default branch tip using ticket-based naming.

4|1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/jcdendrite/claude-config --skill branch-creation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: branch-creation
Source: https://github.com/jcdendrite/claude-config/tree/main/claude/.claude/skills/branch-creation
Command: npx skills add https://github.com/jcdendrite/claude-config --skill branch-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the chaos and hidden risk of starting feature work from a stale or improperly named branch, which leads to messy PR diffs and automation mismatches.

Core Features & Use Cases

  • Consistent, tracker-friendly branch naming: Uses the <TICKET-ID>/<topic-slug> convention when a ticket system exists, and falls back to <topic-slug> when it does not, avoiding non-standard user-prefixed defaults.
  • Branch-from-fresh-default guidance: Ensures branches originate from the current tip of the repo’s default branch (typically main), preventing “baggage” commits and dirty-state carryover.
  • Plan co-location rules: Commits any associated .claude/plans/<name>.md on the implementation feature branch so plans and code ship together in one PR.

Quick Start

Ask the AI to generate a branch name and the correct branching commands for a new feature based on the current default branch tip, including how to commit any related plan file to the same feature branch.

Frequently Asked Questions about branch-creation

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

FAQPage Schema
What is the best way to name feature branches to keep pull requests clean?▼

To keep pull requests clean, name feature branches using a `<TICKET-ID>/<topic-slug>` convention when a ticket system exists, or `<topic-slug>` without one, rejecting non-standard user-prefixed defaults to maintain repository hygiene.

How do I create a feature branch from the latest main tip?▼

Create a feature branch from the latest main tip by standardizing branch creation to always originate from the current default branch tip, preventing "baggage" commits and dirty-state carryover from polluting your pull request diffs.

Why does my feature branch include unrelated commits in the pull request diff?▼

Your feature branch includes unrelated commits because it was not branched from the latest default branch tip, causing dirty-state carryover and "baggage" commits that pollute the pull request diff.

How do I co-locate plan files with feature branch commits?▼

To co-locate plan files with feature branch commits, commit any associated `.claude/plans/<name>.md` plan file directly onto the implementation feature branch so plans and code ship together in one pull request.

When should I not use automated branch naming conventions?▼

You should not use automated branch naming conventions for syncing existing branches or force-pushing cases, as this workflow applies specifically to creating implementation work branches and committing associated plan files.