start-issue

Create a GitHub issue, branch, and git worktree for issue-driven development.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/calebeynon/claude-code-setup --skill start-issue-calebeynon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-issue
Source: https://github.com/calebeynon/claude-code-setup/tree/main/skills/start-issue
Command: npx skills add https://github.com/calebeynon/claude-code-setup --skill start-issue-calebeynon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the setup for starting new work by automatically creating a GitHub issue, a properly named branch, and an isolated git worktree.

Core Features & Use Cases

  • Create a GitHub issue with a consistent title and body for the proposed work.
  • Create a feature-branch and a dedicated git worktree to enable isolated development.
  • Guide through a staged workflow: gather information, confirm details, prepare git state, and launch the work environment.

Quick Start

Type /start-issue to begin the workflow

Frequently Asked Questions about start-issue

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

FAQPage Schema
How do I automatically create a GitHub issue and branch at the same time?

You can automatically create a GitHub issue and a properly named branch together by starting the issue-driven development workflow. This automation links traceable work items directly to isolated feature branches.

How do I set up a git worktree for a new feature branch?

To set up a git worktree for a new feature branch, you run the start workflow which creates the branch and the worktree simultaneously. This enables isolated development environments without leaving your main repository.

Do I need a clean Git workspace on main to create a new worktree and issue?

Yes, you need a clean Git workspace on main to create a new worktree and issue. The automation requires an unmodified main branch state before it can safely generate branches and isolated worktrees.

Can I use the gh CLI to automate issue tracking and branch management?

Yes, you can use the authenticated gh CLI to automate issue tracking and branch management. The workflow relies on your authenticated gh CLI access to generate GitHub issues and prepare your git state.

What is the best way to start issue-driven development with isolated environments?

The best way to start issue-driven development with isolated environments is using an automated workflow that creates a GitHub issue, a dedicated branch, and a git worktree. This ensures traceable work items and isolated feature development.

Why does branch management automation require authenticated gh CLI access?

Branch management automation requires authenticated gh CLI access to securely interact with the GitHub API. Without proper gh CLI authentication, the workflow cannot automatically generate the linked GitHub issue.