How do I install the Linear skill?

Run npx skillmds@latest add zuoguyoupan2023/linear in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Linear safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linear?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linear free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Linear?

zuoguyoupan2023 (@zuoguyoupan2023) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linear by zuoguyoupan2023 — Agent Skill

Name: Linear
Rating: 4.2 (5 reviews)
Author: zuoguyoupan2023

Linear

Linear CLI for issue tracking and project management. Use when developers mention: (1) Linear issues or tickets, (2) issue tracking or task management, (3) WDY team issues, (4) closing, updating, or triaging tickets, (5) linking PRs to issues, (6) issue states (triage, backlog, started, completed).

File contents

Linear CLI

Overview

The Linear CLI (linear) provides command-line access to Linear issue tracking. Installed via Homebrew at /opt/homebrew/bin/linear.

Required Configuration

Commands require LINEAR_ISSUE_SORT to be set:

export LINEAR_ISSUE_SORT=priority

Without this, most commands will fail.

Team

Use linear team list to discover available teams.

Issue States

State	Description
`triage`	New issues needing triage
`backlog`	Prioritized but not started
`unstarted`	Ready to start (Todo)
`started`	In Progress
`completed`	Done
`canceled`	Canceled/Won't do

Common Commands

List Issues

# Active issues (excludes completed/canceled)
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager

# Filter by state
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s started -s unstarted

# All issues including completed/canceled
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager --all-states

View Issue

LINEAR_ISSUE_SORT=priority linear issue view WDY-123 --no-pager

Update Issue Status

linear issue update WDY-123 --state "Done"
linear issue update WDY-123 --state "In Progress"

Create PR Linked to Issue

linear issue pr WDY-123

List Teams

linear team list

Workflows

Check Issues to Close

# List active issues
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s started -s unstarted -s backlog

# Cross-reference with recent commits
git log --oneline -30 --all

Triage New Issues

# View issues in triage
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s triage

---name: lineardescription: Linear CLI for issue tracking and project management. Use when developers mention: (1) Linear issues or tickets, (2) issue tracking or task management, (3) WDY team issues, (4) closing, updating, or triaging tickets, (5) linking PRs to issues, (6) issue states (triage, backlog, started, completed).---# Linear CLI## OverviewThe Linear CLI (`linear`) provides command-line access to Linear issue tracking. Installed via Homebrew at `/opt/homebrew/bin/linear`.## Required ConfigurationCommands require `LINEAR_ISSUE_SORT` to be set:```bashexport LINEAR_ISSUE_SORT=priority```Without this, most commands will fail.## TeamUse `linear team list` to discover available teams.## Issue States| State | Description ||-------|-------------|| `triage` | New issues needing triage || `backlog` | Prioritized but not started || `unstarted` | Ready to start (Todo) || `started` | In Progress || `completed` | Done || `canceled` | Canceled/Won't do |## Common Commands### List Issues```bash# Active issues (excludes completed/canceled)LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager# Filter by stateLINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s started -s unstarted# All issues including completed/canceledLINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager --all-states```### View Issue```bashLINEAR_ISSUE_SORT=priority linear issue view WDY-123 --no-pager```### Update Issue Status```bashlinear issue update WDY-123 --state "Done"linear issue update WDY-123 --state "In Progress"```### Create PR Linked to Issue```bashlinear issue pr WDY-123```### List Teams```bashlinear team list```## Workflows### Check Issues to Close```bash# List active issuesLINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s started -s unstarted -s backlog# Cross-reference with recent commitsgit log --oneline -30 --all```### Triage New Issues```bash# View issues in triageLINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s triage```

Frequently asked questions