linear-workflow

Guide Linear issue creation, updates, and state transitions across workflow stages.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/seankao31/dotfiles --skill linear-workflow-seankao31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-workflow
Source: https://github.com/seankao31/dotfiles/tree/main/agent-config/skills/linear-workflow
Command: npx skills add https://github.com/seankao31/dotfiles --skill linear-workflow-seankao31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates Linear issue work by guiding when to start, file, or update issues, ensuring alignment with workflow and preventing premature automation.

Core Features & Use Cases

  • Entry-point guidance for starting work, filing new issues, and handoffs across the Linear workflow.
  • Enforces proper state transitions (Todo → In Design → Approved → In Progress → In Review → Done) and flags design sessions that require human input.
  • Integrates with the linear CLI for querying, creating, updating, and closing issues, while guarding against duplicates and dependencies.

Quick Start

Ask it to file a new Linear issue or to start implementing work on an existing ticket.

Frequently Asked Questions about linear-workflow

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

FAQPage Schema
How do I automate Linear issue state transitions for an agile workflow?

Automate Linear issue state transitions by enforcing a Todo → In Design → Approved → In Progress → In Review → Done pipeline. The workflow guides when to start, file, or update issues to prevent premature automation and flag design sessions needing human input.

What's the best way to file new Linear issues and flag duplicates?

Filing new Linear issues requires enforcing creation conventions and querying existing tickets to flag duplicates. The workflow integrates with the linear CLI to query, create, and update issues while guarding against duplicates and identifying dependencies.

How do I start implementing work on an existing Linear ticket?

Starting work on an existing Linear ticket involves entry-point guidance for implementation scenarios. The workflow orchestrates autonomous sessions by guiding state transitions from Todo to In Progress and flagging when design sessions require human input before proceeding.

Can I use the linear CLI to coordinate project management handoffs?

The linear CLI coordinates project management handoffs by querying, creating, updating, and closing issues across brainstorming, implementation, and handoff scenarios. It enforces conventions for issue updates and completion while managing dependencies.

When do I need human input during a Linear issue workflow?

Human input is needed during Linear issue workflow when transitioning into the In Design state. The workflow flags design sessions that require human input before approval, preventing premature automation of issue state transitions.

Does this workflow automation prevent premature issue creation in Linear?

Workflow automation prevents premature issue creation in Linear by enforcing conventions for issue creation and state transitions. It guards against duplicates and dependencies while providing entry-point guidance for starting, filing, and handing off work.