linear-start-work

Loads Linear issue context, creates a branch, and implements the issue with validation.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mcmurrym/coding-agent-skills --skill linear-start-work-mcmurrym
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-start-work
Source: https://github.com/mcmurrym/coding-agent-skills/tree/main/agent-skills/linear-start-work
Command: npx skills add https://github.com/mcmurrym/coding-agent-skills --skill linear-start-work-mcmurrym

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting work on a Linear issue usually requires manually gathering issue details, comments, linked documents, and sub-issues, then figuring out where in the codebase to make changes. This Skill automates that entire kickoff: it pulls full issue context, researches the repository, creates a branch, moves the issue to In Progress, and implements the change with a structured preflight review. ## Core Features & Use Cases - Full Issue Context Loading: Fetches the Linear issue with comments, attachments, linked documents/notes, parent issue, and child sub-issues before planning. - Depth-Gated Planning: Runs a preflight gate covering invariants, data-access safety, failure handling, reviewer risks, and an acceptance-to-validation map before writing code. - Branch and Status Automation: Creates and pushes a git branch from the issue's branch name or a title-derived slug, then moves the issue to In Progress. - Use Case: A developer pastes a Linear issue URL and says "start work". The Skill summarizes the issue and linked docs, inspects the repo, prints a preflight plan, creates the branch, updates the status, and implements the change with tests. ## Quick Start Ask the assistant to start work on a Linear issue by providing its URL or key, for example: start work on ENG-1234.

Frequently Asked Questions about linear-start-work

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

FAQPage Schema
How do I start coding work from a Linear issue automatically?▼

Provide a Linear issue URL or key and ask to start work. The Skill fetches the issue with comments, linked documents, parent and sub-issues, researches the repository, creates a branch, moves the issue to In Progress, and implements the change with validation.

What context does this Skill load from a Linear issue?▼

It loads the issue description, all comments, attachments, linked Linear documents and notes with their comments, the parent issue, and child sub-issues. Linked documents are treated as required context, and missing documents are flagged as blockers or assumptions.

Can I skip branch creation when starting a Linear issue?▼

Yes. Say "no branch", "stay on current branch", or similar, and the Skill skips branch creation and proceeds directly to research and implementation. Otherwise it uses the issue's branchName field or derives a slug from the title.

What is the preflight depth gate before implementation?▼

It is a mandatory planning step that checks invariants, data-access safety, failure handling, and reviewer risks, plus an acceptance-to-validation map. If any high-risk item is unclear, the Skill stops and asks before writing code.

When does the Skill stop instead of implementing the issue?▼

It stops only when requirements, ownership, production safety, or high-risk behavior are genuinely unclear, or when a linked document cannot be fetched and is flagged as a blocker. A "go" decision in preflight means it proceeds without waiting for confirmation.