linear

Automate Linear issue lifecycle from creation through PR integration.

2|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/ryantking/agentctl --skill linear-ryantking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/ryantking/agentctl/tree/main/internal/templates/templates/skills/linear
Command: npx skills add https://github.com/ryantking/agentctl --skill linear-ryantking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the end-to-end Linear issue lifecycle, reducing manual coordination and speeding up planning, grooming, and delivery of tasks.

Core Features & Use Cases

  • Create Linear Issue: Research-driven issue creation with templates, project matching, and automatic assignment.
  • Decompose Feature into Sub-Tasks: Breaks work into parallelizable sub-tasks with clear acceptance criteria and independent execution.
  • Start Work on Issue: Handles branch naming, worktrees, and spawning parallel workers for complex issues.
  • Complete Work and Create PR: Orchestrates PR creation, checks status, and updates Linear states in sync.
  • Use Case: Imagine a feature requiring four sub-tasks; the skill creates the parent, decomposes into sub-tasks, and coordinates parallel work until merge.

Quick Start

Use the linear skill to create a new Linear issue from a description, optionally decompose into sub-tasks, start work, and manage PRs.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I automate Linear issue lifecycle management from creation to pull request?

Automating Linear issue lifecycle management involves creating issues, decomposing features into sub-tasks, handling branch naming, and synchronizing status updates with pull requests. This reduces manual coordination across the entire workflow.

What is the best way to decompose a Linear feature into parallel sub-tasks?

To decompose a Linear feature into parallel sub-tasks, break work into independent units with clear acceptance criteria. The automation creates the parent issue and generates parallelizable sub-tasks for independent execution.

Can I use git worktrees with Linear issue branching workflows?

Yes, git worktrees integrate with Linear issue branching workflows by automatically handling branch naming and worktree creation when starting work. This enables parallel task spawning for complex issues across separate working directories.

Does Linear status synchronization update issue states automatically when a PR is created?

Yes, Linear status synchronization automatically updates issue states when a pull request is created. The automation orchestrates PR creation, checks status, and updates Linear states in sync to maintain tracking accuracy across platforms.

Do I need research integration to create Linear issues with templates automatically?

Research integration is required to create Linear issues with templates, project matching, and automatic assignment. The automation leverages research data to populate issue content accurately and match issues to the correct projects.

When should I not use automated sub-task decomposition for issue tracking?

Automated sub-task decomposition for issue tracking should not be used when work items are tightly coupled and cannot execute independently. The automation assumes sub-tasks have clear acceptance criteria and can run in parallel without dependencies.