kata-linear

Plan and coordinate Linear ticket lifecycle workflows with context loading and branch creation.

2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/gannonh/skills --skill kata-linear
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-linear
Source: https://github.com/gannonh/skills/tree/main/kata-linear
Command: npx skills add https://github.com/gannonh/skills --skill kata-linear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aligns and orchestrates a Linear ticket lifecycle from start to finish by providing structured start/next/end workflows, blocker validation, and context loading to guide decisions.

Core Features & Use Cases

  • Start, Next, and End workflows for Linear issues across projects.
  • Context loading from issue descriptions and project docs to inform decisions.
  • Automatic branch creation and status transitions with project-specific guardrails.
  • Use Case: When starting work on a Linear ticket, the skill loads context, creates a feature branch, and guides you through the next actions.

Quick Start

Initiate a Linear ticket lifecycle by telling the skill to Start, Next, or End a KAT-N workflow and follow the prompts.

Frequently Asked Questions about kata-linear

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

FAQPage Schema
How do I manage a Linear ticket lifecycle from start to finish?

A Linear ticket lifecycle is managed by orchestrating structured start, next, and end workflows. This process loads context from issue descriptions and project docs to guide decisions, validate blockers, and automate branch creation with gated status transitions.

Can I automatically create a feature branch when starting a Linear issue?

Yes, automatic branch creation occurs when starting a Linear issue. The workflow loads context from the issue description and project documentation, then creates a feature branch while applying project-specific guardrails from your configuration files.

What is the best way to determine what Linear task to work on next?

To determine the next Linear task, the workflow validates blockers and loads context from project docs. It applies mode detection to identify the next available issue and guides you through required actions before advancing any work in progress.

How does context loading work for Linear project management workflows?

Context loading for Linear workflows extracts information from issue descriptions and project-specific documentation. This data informs decisions by applying project-specific guidance, ensuring guardrails are met before executing gated transitions or branch creation.

Do I need a CLAUDE.md file to use Linear workflow automation?

A CLAUDE.md file is required to provide project-specific guidance for Linear workflow automation. It supplies the guardrails and configuration needed to execute mode detection, gated transitions, and context loading accurately across different software projects.

Why are my Linear issue status transitions blocked during development?

Linear issue status transitions are blocked by gated validation checks. The workflow enforces project-specific guardrails from configuration files, ensuring all blockers are resolved and context loading requirements are met before advancing ticket status.