Loading...

feature-branch

Original：🇺🇸 English

Translated

Create a feature branch in a git worktree from a GitHub issue

1installs

Sourcesmartworkx/dev-context

Added on2026-03-01

NPX Install

npx skill4agent add smartworkx/dev-context feature-branch

Tags

Translated version includes tags in frontmatter

git-worktree github-issues feature-branching git-commands gh-cli

SKILL.md Content

View Translation Comparison →

Create a feature branch in a new git worktree, as a sibling directory of the current project.

Steps

Determine the issue — the argument can be:
- A GitHub issue number or URL → fetch with
```
gh issue view
```
- A description → search with
```
gh issue list --search "<description>"
```
  to find the matching issue
- Nothing → ask the user what they're working on, then search
Generate a branch name:
- Format:
```
<issue-number>-<kebab-case-summary>
```
  (e.g.
```
42-add-user-export
```
  )
- Keep it under 50 characters where possible
Ensure
```
main
```
is up to date:
- ```
git fetch origin main
```
Create a worktree as a sibling of the current project directory:
- ```
git worktree add ../<branch-name> -b <branch-name> origin/main
```
- This creates
```
../<branch-name>/
```
  alongside the current project directory
Confirm to the user:
- Show the branch name
- Show the worktree path
- Summarize what the issue is about
- Remind them to
```
cd ../<branch-name>
```
  to start working