skills.rest
cilly-yllic
cilly-yllicCOMMUNITY
Explore all skills by this author →
GitHub

__switch-issue

Resolve an issue number or URL and switch to the matching work branch.

Updated May 13, 2026
Search Tags:#git#Linear#GitHub#issue tracking#Jira#branch switching#resume context
One-click install
npx skills add https://github.com/cilly-yllic/.llm --skill switch-issue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: __switch-issue
Source: https://github.com/cilly-yllic/.llm/tree/main/skills/ja/__switch-issue
Command: npx skills add https://github.com/cilly-yllic/.llm --skill switch-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually finding the correct branch for an issue (or creating one) is slow and error-prone, especially when you only have an issue number or URL.

Core Features & Use Cases

  • Issue identification from number or URL: Detects the issue target and infers the issue management service (GitHub Issues, Linear, Jira, Notion, or fallback).
  • Branch discovery and safe selection: Searches local and remote branches for matching issue identifiers and helps you choose the correct one or create a new branch.
  • Context restoration with resume: When requested via --resume, continues by running __resume-branch-context to reconstruct PR/Issue/commit history context after switching.

Quick Start

Run __switch-issue with the issue number or URL and (optionally) -r to automatically restore context after switching.

Frequently Asked Questions about __switch-issue

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

FAQPage Schema
How do I switch to the correct git branch from an issue number or URL?▼

You can switch to the correct git branch from an issue by providing its number or URL. The tool detects the issue service, searches local and remote branches for matching identifiers, and helps you select or create the correct branch.

What is the best way to find a work branch for a Linear or Jira issue across multiple repositories?▼

The best way to find a work branch for a Linear or Jira issue across multiple repositories is to use a tool that resolves the issue identifier and searches local and remote branches matching that pattern across your repositories.

Does branch switching from issue URLs work with GitHub Issues and Notion?▼

Yes, branch switching from issue URLs supports GitHub Issues, Linear, Jira, and Notion. The tool detects the issue management service from the URL and infers the correct target for branch discovery and creation.

Can I automatically restore commit and PR context after switching branches?▼

Yes, you can automatically restore commit and PR context after switching branches by using the --resume flag, which chains to context restoration to reconstruct PR, Issue, and commit history for the target branch.

What happens if a matching branch is not found when switching from an issue?▼

If a matching branch is not found when switching from an issue, the tool prompts you with user confirmation to safely create a new branch that follows the issue identifier pattern, preventing accidental or duplicate branch creation.

Related Skills

Explore More Software Engineering Skills→
JuanMS20JuanMS20

github-auth

Configure GitHub authentication for Hermes Agent using git, gh CLI, or SSH credentials.

Community
Intermediate
cilly-ylliccilly-yllic

__resume-branch-context

Collect pull request, issue, and commit context for the current branch.

Community
Intermediate
fpindejfpindej
230

create-pr

Create pull requests for Git repositories with commit history analysis and templates.

Community
Advanced
drillandrillan
1

add-worktree

Create a Git worktree for a GitHub issue with branch naming checks.

Community
Advanced