intake-issue

Parse GitHub issues to create feature branches and initialize worktrees.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, jq, and includes scripts (resource) components.

What problem does it solve?

Intake GitHub issues or tasks manually wastes time and introduces delays between planning and starting development.

Core Features & Use Cases

  • Parse a GitHub issue URL or number to derive a consistent branch type and slug.
  • Create a dedicated git worktree alongside the main repository for isolated development per issue.
  • Initialize the development environment in the new worktree by running the appropriate package manager/install scripts and setting up required tools.
  • Use-case: A team member submits an issue; the skill automatically creates a feature branch, a worktree, and bootstraps the environment for immediate work.

Quick Start

Provide a GitHub issue URL or issue number to automatically create a branch, set up a worktree, and initialize the dev environment.

Frequently Asked Questions about intake-issue

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

FAQPage Schema
How do I automate GitHub issue intake to create a branch and worktree?

Automating GitHub issue intake uses scripts to parse an issue URL or number, derive a consistent branch type and slug, create a dedicated git worktree in a sibling directory, and bootstrap the development environment for immediate work.

What is a git worktree and when do I need it for issue-driven development?

A git worktree creates an isolated working directory alongside your main repository, allowing you to checkout a feature branch for a specific issue without disrupting your current development state or stashing changes.

Do I need the gh CLI to set up a worktree from a GitHub issue?

Yes, you need the gh CLI installed and authenticated to fetch GitHub issue data from a URL or issue number. However, if you provide raw text instead, jq handles the JSON parsing without requiring gh.

How to initialize a development environment automatically after creating a branch?

To initialize a development environment automatically, the skill runs an init-worktree script that executes appropriate package manager install scripts and sets up required tools within the new worktree directory to ensure dependencies are ready for development.

Can I use this automated worktree setup for team workflows?

Yes, this automated worktree setup is applicable to issue-driven workflows across teams. It standardizes branch naming and environment bootstrapping so every team member starts from a consistent development state when picking up a submitted issue.

What are the limitations of using git worktrees for isolated development?

A limitation of using git worktrees is that they consume additional disk space for each isolated branch directory. You should also avoid checking out the same branch in multiple worktrees simultaneously, as git restricts a branch to a single working tree to prevent file conflicts.