How do I install the Linear skill?

Run npx skillmds@latest add glebis/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?

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

Linear by glebis — Agent Skill

Name: Linear
Rating: 4.5 (4 reviews)
Author: glebis

Linear

Manage Linear issues, projects, and workflows via CLI. This skill should be used when the user wants to create, list, update, or search Linear issues, manage projects or milestones, or interact with their Linear workspace. Triggers on "create a task", "add a Linear issue", "list my issues", "update GLE-123", "what's in my backlog", or any Linear-related request.

glebis 4dc3a05 3 files · 18.6 KB Updated Sep 9, 2026

File contents

Linear CLI

Standalone CLI for the Linear issue tracker. Zero dependencies beyond Python 3.

Setup

On first use, authenticate via browser OAuth (no API keys needed):

linear auth

Opens the browser for Linear authorization. Uses MCP Dynamic Client Registration + PKCE — credentials are stored at ~/.config/linear/ with 0600 permissions.

The CLI script is bundled at scripts/linear within this skill directory. Execute it directly or reference its absolute path.

Commands

Create an issue

linear create "Issue title" \
  --team GLE \
  --state Todo \
  --assignee me \
  --due today \
  --priority high \
  --description "Markdown description" \
  --label "Bug"

Priority: urgent, high, medium, low, none (or 0-4).

Due date: YYYY-MM-DD, today, tomorrow.

List issues

linear list --mine --status "In Progress"
linear list --team GLE --status Todo --limit 10
linear list --priority high --json

Show issue details

linear show GLE-123
linear show GLE-123 --json

Update an issue

linear update GLE-123 --state "In Progress"
linear update GLE-123 --priority urgent --due 2026-05-01
linear update GLE-123 --assignee me --title "New title"

Add a comment

linear comment GLE-123 "This is done, merging now"

Workspace info

linear teams
linear me
linear statuses --team GLE
linear labels --team GLE

Conventions

Use team key (e.g. GLE), not full team name, in --team flags.
Default assignee: me unless specified otherwise.
Default state for new issues: Todo.
Use --due today for same-day tasks.
The CLI outputs human-readable text by default; pass --json for machine-readable output.
When creating issues from conversation context, write a concise title and structured markdown description.

---name: lineardescription: Manage Linear issues, projects, and workflows via CLI. This skill should be used when the user wants to create, list, update, or search Linear issues, manage projects or milestones, or interact with their Linear workspace. Triggers on "create a task", "add a Linear issue", "list my issues", "update GLE-123", "what's in my backlog", or any Linear-related request.--- # Linear CLI Standalone CLI for the Linear issue tracker. Zero dependencies beyond Python 3. ## Setup On first use, authenticate via browser OAuth (no API keys needed): ```bash linear auth ``` Opens the browser for Linear authorization. Uses MCP Dynamic Client Registration + PKCE — credentials are stored at `~/.config/linear/` with `0600` permissions. The CLI script is bundled at `scripts/linear` within this skill directory. Execute it directly or reference its absolute path. ## Commands ### Create an issue ```bash linear create "Issue title" \ --team GLE \ --state Todo \ --assignee me \ --due today \ --priority high \ --description "Markdown description" \ --label "Bug" ``` Priority: `urgent`, `high`, `medium`, `low`, `none` (or 0-4). Due date: `YYYY-MM-DD`, `today`, `tomorrow`. ### List issues ```bash linear list --mine --status "In Progress" linear list --team GLE --status Todo --limit 10 linear list --priority high --json ``` ### Show issue details ```bash linear show GLE-123 linear show GLE-123 --json ``` ### Update an issue ```bash linear update GLE-123 --state "In Progress" linear update GLE-123 --priority urgent --due 2026-05-01 linear update GLE-123 --assignee me --title "New title" ``` ### Add a comment ```bash linear comment GLE-123 "This is done, merging now" ``` ### Workspace info ```bash linear teams linear me linear statuses --team GLE linear labels --team GLE ``` ## Conventions - Use team key (e.g. `GLE`), not full team name, in `--team` flags. - Default assignee: `me` unless specified otherwise. - Default state for new issues: `Todo`. - Use `--due today` for same-day tasks. - The CLI outputs human-readable text by default; pass `--json` for machine-readable output. - When creating issues from conversation context, write a concise title and structured markdown description.

Frequently asked questions