git-workspace-init

Create an isolated git worktree with conventional branch naming and upstream tracking.

5|Updated Nov 27, 2025
One-click install
npx skills add https://github.com/BillChirico/bills-claude-skills --skill git-workspace-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workspace-init
Source: https://github.com/BillChirico/bills-claude-skills/tree/main/git-workspace-init
Command: npx skills add https://github.com/BillChirico/bills-claude-skills --skill git-workspace-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual, error-prone process of setting up new Git branches and isolated worktrees. It automates conventional branch naming and workspace creation, saving developers time and ensuring consistency.

Core Features & Use Cases

  • Automated Branch Naming: Generates conventional branch names (e.g., feat/user-authentication, fix/login-validation-error) based on task type and description.
  • Isolated Workspaces: Creates Git worktrees, allowing you to work on multiple branches simultaneously without stashing or switching.
  • Remote Push Setup: Automatically pushes new branches to the remote repository with upstream tracking.
  • Use Case: When starting a new feature, bug fix, or any task requiring an isolated development environment, this skill quickly sets up your workspace according to best practices.

Quick Start

Use the git-workspace-init skill to create a new feature branch for 'user authentication'.

Frequently Asked Questions about git-workspace-init

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

FAQPage Schema
How do I automate creating git branches with conventional naming?

Conventional branch naming automatically generates branch names like `feat/user-authentication` or `fix/login-error` based on task type and description. This Skill enforces that naming standard, eliminating manual naming errors and ensuring consistency across your team's workflow.

What's the difference between switching branches and using git worktrees?

Git worktrees let you work on multiple branches simultaneously without stashing changes or switching contexts. This Skill creates isolated worktrees, so you can develop a feature and fix a bug in parallel without losing work or disrupting your current branch.

How do I set up a new feature branch with remote tracking automatically?

This Skill creates a worktree from your base branch, generates a conventional branch name, and pushes it to remote with upstream tracking in one step. Your new branch is immediately ready for pushing commits without manual remote configuration.

When should I use git worktrees instead of just creating a new branch?

Use worktrees when you need to work on multiple tasks simultaneously—feature development, bug fixes, hotfixes, or refactoring—without context switching. Worktrees keep your workspaces isolated and let you build and test in parallel.

Can I use this Skill for any type of development task?

Yes. This Skill handles features, bug fixes, hotfixes, documentation updates, and refactoring. It applies conventional branch naming across all task types, adapting the prefix (`feat/`, `fix/`, `hotfix/`, `docs/`, `refactor/`) based on your input.

What happens if my branch naming doesn't follow conventions?

This Skill enforces conventional branch naming automatically—you provide the task type and description, and it generates the properly formatted name. This eliminates inconsistent naming and ensures your repository follows branching standards.