linear-fix

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

Updated Jul 11, 2022
One-click install
npx skills add https://github.com/kvnxiao/.dotfiles --skill linear-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-fix
Source: https://github.com/kvnxiao/.dotfiles/tree/main/claude/skills/linear-fix
Command: npx skills add https://github.com/kvnxiao/.dotfiles --skill linear-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill autonomously completes Linear tickets by creating a dedicated git worktree per ticket and driving end-to-end resolution through autonomous planning, review, and PR creation.

Core Features & Use Cases

  • Isolated worktrees per ticket to keep work isolated and easily revertible.
  • Automatic planning and review loops that generate and validate implementation approaches.
  • Integration with linear-cli to fetch ticket details and comments, and with GitHub CLI to open PRs including reasoning.
  • Works when given a Linear ticket ID or URL and handles typical ticket patterns (e.g., ENG-123, LIN-456).

Quick Start

/linear-fix ENG-123 /linear-fix https://linear.app/your-team/issue/ENG-123/title

Frequently Asked Questions about linear-fix

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

FAQPage Schema
How do I automate Linear ticket resolution and pull request creation?

Automating Linear ticket resolution involves fetching ticket details via linear-cli, creating an isolated git worktree, executing planning and review loops, and opening a GitHub PR. This Skill orchestrates that entire workflow end-to-end from a single ticket ID or URL.

Can I use git worktrees to isolate development work for individual Linear tickets?

Yes, using git worktrees for Linear tickets isolates changes per task, keeping work easily revertible. This Skill automatically provisions a dedicated worktree for each ticket before driving implementation and review workflows.

What's the best way to auto-generate pull requests with planning and code review context from Linear?

Generating PRs with planning and review context is handled by integrating linear-cli and GitHub CLI. This Skill fetches ticket details, runs autonomous review loops, and incorporates the reasoning outputs directly into the PR body.

Does this Linear automation tool require a specific ticket ID format to start?

No specific format is required beyond standard Linear ticket patterns like ENG-123 or LIN-456. You can provide either a bare ticket ID or a full Linear URL to trigger the automated worktree creation and PR workflow.

Why use a git worktree for automated ticket implementation instead of working on the main branch?

Using a git worktree keeps automated ticket implementation isolated from your main working directory, preventing branch conflicts and making experimental changes easily revertible if the autonomous planning or review loops need adjustment.

What happens after the autonomous planning and review loops finish for a Linear ticket?

After planning and review loops finish, the implementation is validated and a GitHub pull request is automatically opened using GitHub CLI, with the generated reasoning and review outputs embedded directly into the PR body.