Does this skill require the Linear CLI?

Yes, it utilizes the Linear CLI to fetch issue data and create new tasks, ensuring that it respects your local authentication and permissions.

How does this skill identify which Linear issue to use?

It queries the Linear CLI for issues assigned to you in 'unstarted' or 'started' states and uses the conversation context to find the most relevant match.

What happens if a matching issue doesn't exist in Linear?

The skill will signal that a new issue is needed, prompting Claude to ask you for details and create the issue for you before setting up the worktree.

How are branch names formatted?

Branch names are formatted using a standard prefix (e.g., feat, fix, chore) followed by the Linear Issue ID and a slugified version of the title, limited to 50 characters.

Can I use this skill if I am working offline?

Yes, if the Linear API is unreachable, the skill provides a fallback mechanism to create a local worktree based on the topic without a linked issue ID.

Linear Worktree Integration

Name: Linear Worktree Integration
Author: CaptainCrouton89

byCaptainCrouton89

•

Collaboration Tools

Streamlines development workflows by automatically linking Linear issues to standardized Git worktree environments.

The Linear Worktree skill bridges the gap between project management and local development by synchronizing your Linear ticket queue with your Git environment. It intelligently scans your assigned unstarted and in-progress issues to find a match for your current task, inferring the correct work type—such as feature, fix, or refactor—and generating a clean, URL-friendly slug. By automating the branch naming and worktree creation process through Claude Code, it eliminates manual overhead and ensures your development environment is always perfectly aligned with your project tracking software.

Key Features

01Integrated fallback for creating new issues directly from the terminal

02Standardized slug generation for consistent branch naming

0324 GitHub stars

04Contextual Linear issue matching for unstarted and active tasks

05Offline-ready workflow that maintains productivity when Linear is unavailable

06Automatic branch type inference (feat, fix, refactor, chore, docs)

Use Cases

01Maintaining consistent naming conventions across complex repositories using worktrees

02Reducing context switching by managing issue status and local environments in one place

03Rapidly initializing a feature branch that is automatically linked to a Linear ticket

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add captaincrouton89/crouton-kit linear-worktree

For use in Claude.ai and ChatGPT

Download Skill