skills.rest
tillysoso
tillysosoCOMMUNITY
Explore all skills by this author →
GitHub

linear-worktree

Create a git worktree for a Linear issue beside the current repository.

Updated Sep 10, 2025
Search Tags:#git#worktree#linear#parsing#dev-workflow#branch-derivation
One-click install
npx skills add https://github.com/tillysoso/mv1 --skill linear-worktree-tillysoso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-worktree
Source: https://github.com/tillysoso/mv1/tree/main/.claude/skills/linear-worktree
Command: npx skills add https://github.com/tillysoso/mv1 --skill linear-worktree-tillysoso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a git worktree for a Linear issue as a sibling of the current repository, allowing you to work on the issue without affecting the main repo.

Core Features & Use Cases

  • Derives ISSUE_ID and BRANCH from a Linear URL, a copy as prompt, or an issue id.
  • Creates a deterministic worktree path alongside the current repository and checks out the main branch.
  • Handles common edge cases and provides clear instructions to switch to the new worktree when done.

Quick Start

Provide a Linear URL, a copy as prompt, or an issue ID to generate and set up a worktree beside the current repository.

Frequently Asked Questions about linear-worktree

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

FAQPage Schema
How do I create a git worktree for a Linear issue next to my current repository?▼

To create a git worktree for a Linear issue, provide a Linear URL, copy-as-prompt, or issue ID. The tool derives the issue ID and branch, runs git fetch origin main, and adds the worktree as a sibling to your current repository.

Can I use a Linear URL or issue ID to automatically derive a git branch name?▼

Yes, you can use a Linear URL, a copy-as-prompt, or an issue ID to automatically derive the ISSUE_ID and BRANCH. This parsed information is used to check out the target branch in the new worktree.

What is the best way to work on a Linear issue without affecting my main git repository?▼

Creating a git worktree as a sibling of your current repository lets you work on a Linear issue without affecting the main repo. It fetches the main branch and checks out the derived branch at a deterministic sibling path.

Does the Linear worktree creation process require any specific git dependencies or local environment setup?▼

The process requires a local git environment capable of running git fetch origin main and git worktree add. No external skill dependencies are needed, but the current repository must exist to derive the sibling worktree location.

How does the tool determine the file path location when adding a new git worktree?▼

The tool determines the worktree path by creating a deterministic sibling location alongside your current repository. It uses the parsed Linear issue data to define the target path before running the git worktree add command.

What should I do after successfully creating a git worktree for my Linear issue?▼

After creating the git worktree, the tool provides clear instructions to switch to the new worktree directory. You can then start working on your Linear issue in this isolated environment without impacting the main repository.

Related Skills

Explore More Software Engineering Skills→
coryfincoryfin

start-task

Fetch Linear issue details, update local task tracking, and provide implementation guidance.

Community
Intermediate
kvnxiaokvnxiao

linear-fix

Create per-ticket git worktrees and generate GitHub PRs for Linear tickets.

Community
Advanced
rarebit-onerarebit-one

start

Update Linear issues to In Progress and create Git branches.

Official
Advanced
pegasus-isipegasus-isi

start

Create issue-linked git branches and worktrees via GitHub CLI.

Official
Intermediate