# linear

Guides the agent through Linear task tracking using the CLI or GraphQL API. Helps write concise issue descriptions and link pull requests cleanly.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 62
- Author: wendylabsinc
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wendylabsinc/claude-skills/tree/HEAD/linear/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/wendylabsinc-linear

## What it does

The skill enables task management in Linear through a dual approach. It first checks whether the `linear` command-line binary is present. Whenever the CLI is missing or cannot run a specific task, the assistant switches to direct requests against `https://api.linear.app/graphql`.

CLI usage requires an explicit setting: `LINEAR_ISSUE_SORT=priority`. Most commands fail immediately without it. Direct API access relies on `LINEAR_API_KEY`, which the instructions forbid printing, echoing into logs, or checking into version control.

Issue drafting follows a strict format starting with an unadorned summary of the problem. The instructions explicitly prohibit inventing acceptance criteria, user personas, or technical solutions. Pull requests connect back to tasks using exact relationship tags such as `Closes`, `Advances`, or `Related`.

## Requirements
- Works with: Linear

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill linear -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/linear/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/linear/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill linear -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/linear/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill linear -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/linear/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wendylabsinc/claude-skills linear
```

2. **Manually: put the files in place**
- File: `.github/skills/linear/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill linear -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/wendylabsinc/claude-skills --path linear
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/linear/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add wendylabsinc/claude-skills --skill linear -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/wendylabsinc/claude-skills/tree/HEAD/linear/SKILL.md

## When to use it
- list active team issues filtered by state
- draft minimal issue descriptions without speculative requirements
- link pull requests to issues with accurate progress verbs
- query Linear GraphQL endpoints without leaking API tokens

## Example prompts
- List all unstarted tasks for team WDY
- Draft a Linear ticket for this crash without adding assumed acceptance criteria
- Link this PR to issue WDY-123 using the Closes tag

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

## Other versions with the same name
- [linear · davila7](https://affpapa.org/en/nevibecode/skills/linear.md) — 76 installs
- [Linear · wrsmith108](https://affpapa.org/en/nevibecode/skills/ryan-smith-linear.md) — ★ 138

From the same set: [wendylabsinc/claude-skills](https://affpapa.org/en/nevibecode/by/wendylabsinc/claude-skills.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md