# Gh Linking Branches To Issues

> Creates and links a development branch to an issue. Use to start implementation work.

- Skill: `yu-iskw-github-project-skills/gh-linking-branches-to-issues` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add yu-iskw-github-project-skills/gh-linking-branches-to-issues`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yu-iskw-github-project-skills/gh-linking-branches-to-issues/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yu-iskw (https://skillmd.com/u/yu-iskw-github-project-skills)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/yu-iskw-github-project-skills/gh-linking-branches-to-issues

---


# Linking Branches to Issues

## Purpose

Manages development branches using the `gh issue develop` command.

## 1. Safety & Verification

- **Mandatory Context**: Ensure `gh-verifying-context` has been run and confirmed by the user.
- **Human-in-the-Loop**: You MUST confirm the branch name and the target issue with the user before creation.
- **Repository Check**: Ensure you are in the correct repository (work vs personal) before creating a branch.

## 2. Common Workflows

### Workflow: Create Linked Branch

Creates a new branch and links it to the issue.

**Command**:

```bash
gh issue develop <issue-number> --name "feature-x"
```

## 3. Reference

See [references/commands.md](references/commands.md) for the full flag reference, branch naming conventions, and verification command.