Skip to main content
skill CX Codex

linear · glebis — Claude Code skill: Linear tasks and installation

Use the linear CLI to create, find, and update Linear issues. It also handles comments and workspace lookups.

MIT 170 installs ★ 414 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add glebis/claude-skills --skill linear -a claude-code
Open on GitHub

What linear does

The skill calls the linear CLI to create issues, filter lists, inspect issue details, change fields, and post comments. It can also retrieve workspace information such as teams, statuses, and labels. Add --json when you need machine-readable output.

Run linear auth on first use and authorize access in your browser. The CLI requires Python 3 and does not need an API key. For --team, pass the team key, such as GLE, rather than its full name.

What it helps with

  • create an issue with an assignee and due date
  • find assigned issues by status or team
  • change an issue's state or priority
  • post a comment on an issue
  • inspect a team's statuses and labels

Example prompts for the agent

  • Create a Todo issue for team GLE titled “Update the login page”.
  • List my issues with the status In Progress.
  • Set GLE-123 to priority urgent and comment that it is ready for review.

How to install linear

1Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill linear -a claude-code

2Manually: put the files in place

~/.claude/skills/linear/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/linear/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about linear

How do I install linear in Claude Code?

Run npx skills add glebis/claude-skills --skill linear -a claude-code. The skill file is at ~/.claude/skills/linear/SKILL.md.

What does the linear skill do?

It uses the linear CLI to create, search, and edit issues, view their details, and add comments. It can also retrieve workspace information.

Does linear need an API key?

No API key is needed. Run linear auth and authorize through the browser on first use; the CLI requires Python 3.

Source text

SKILL.md · MIT
---
name: linear
description: 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.

© glebis · MIT · glebis/claude-skills

Similar skills

All skills for Notes, tasks and projects →

linear by other authors comes first.

linear vercel-labs linear — Claude Code skill for local testing. Mocks Linear API, issues, webhooks, and OAuth flows. CX Codex +1 113installs linear membrane Connects Claude Code and coding agents to Linear via Membrane CLI to manage issues, projects, cycles, and labels. CX Codex +1 176installs linear davila7 Orchestrates Linear issue tracking, sprint planning, and team workflows directly within Claude Code using MCP tools. CX Codex +1 76installs Linear Ryan Smith Manages Linear issues, projects, and teams using MCP tools, the Linear CLI, or helper scripts directly inside your agent session. CX Codex +1 ★ 141repo stars linear wendylabsinc Guides the agent through Linear task tracking using the CLI or GraphQL API. Helps write concise issue descriptions and link pull requests cleanly. CX Codex +1 ★ 64repo stars linear-cli schpet linear-cli is a Claude Code skill for managing Linear work items, projects, and documents through the CLI. It activates for Linear requests or IDs such as ENG-123. CX Codex +1 16,900installs Linear Automation Claude Office Skills Linear Automation automates Linear issue tracking, Git branch and PR syncing, and two-week cycle planning through project-mcp tools. CX Codex +1 4,800installs linear-sdk-scripting cline linear-sdk-scripting — a skill to manage Linear through Node scripts using the official @linear/sdk. Works across all AI coders: read, create, and update tasks, projects, comments, and metadata without an MCP server. CX Codex +1 1,400installs pp-linear Matt Van Horn pp-linear is a Claude Code skill that uses a CLI to query and update Linear data. It activates for sprint planning, stale-issue cleanup, cycle comparisons, and milestone risk checks. CX Codex +1 649installs linear-dev-accelerator manutej linear-dev-accelerator controls Linear issues and project roadmaps via MCP tools inside your coding agent. Keeps track of tasks, bug reports, and sprint backlogs during development. CX Codex +1 448installs sync-linear-to-issues davila7 sync-linear-to-issues transfers Linear tasks to GitHub issues with state mapping, attachment migration, and comment sync. Useful when consolidating project tracking into GitHub. CX Codex +1 123installs

From the same set51

The whole set →

Project sponsors

Companies that keep this analytics open