linear-issue-workflow

Transform a Linear issue into a planned, reviewed implementation workflow.

4|2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/alexanderguy/skills --skill linear-issue-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-issue-workflow
Source: https://github.com/alexanderguy/skills/tree/main/skills/linear-issue-workflow
Command: npx skills add https://github.com/alexanderguy/skills --skill linear-issue-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents stalled feature work by turning a Linear issue into a complete, reviewable implementation plan and branch-ready change set.

Core Features & Use Cases

  • Issue-to-plan workflow: Fetches issue details, clarifies unclear scope, and generates a structured implementation plan that matches repository and issue conventions.
  • Branch worktree setup: Creates an isolated worktree branch based on the remote default branch to ensure changes start from the latest code.
  • Self-review gate with iterative fixes: Runs a whole-branch code review, fixes every finding, and repeats up to three passes until the branch is review-clean or escalates for user decision.

Quick Start

Use linear-issue-workflow for implementing a Linear-tracked feature or fix by providing the Linear issue ID (and optionally a reviewer) so it can plan, set up the worktree, implement, and gate with an end-to-end self-review.

Frequently Asked Questions about linear-issue-workflow

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

FAQPage Schema
How do I turn a Linear issue into an implementation plan and shippable pull request?

To turn a Linear issue into a shippable pull request, you can use a workflow that fetches the issue details, clarifies scope, generates a structured implementation plan, sets up an isolated worktree branch, and runs a self-review gate before delivery.

How do I set up a git worktree from the remote default branch for feature development?

You can set up a git worktree for feature development by creating an isolated branch based directly on the repository's remote default branch, ensuring your code changes start from the latest updated source baseline.

How do I automate code review and iterative fixes on a feature branch before opening a PR?

You can automate code review on a feature branch by running a whole-branch diff self-review, fixing every finding, and repeating the cycle iteratively up to three passes until the branch is review-clean or requires user escalation.

Can I attach an implementation plan to a Linear issue automatically?

Yes, you can attach an implementation plan to a Linear issue automatically by using Linear MCP tools to retrieve the issue and upload the generated implementation plan directly to the issue record.

Does the linear-issue-workflow require user approval before starting code implementation?

Yes, the linear-issue-workflow requires explicit user approval before starting implementation, ensuring you review and confirm the generated implementation plan and worktree setup before any code changes are executed.

What happens if code review findings remain after multiple fix cycles on a feature branch?

If code review findings remain after iterative fix cycles on a feature branch, the workflow escalates the unresolved issues for a user decision, potentially applying a Greybeard waiver to bypass specific non-critical findings.