# Linear Tasks

> Linear issue tracking and project management. Use for creating issues, searching issues, getting issue details, and managing tasks in Linear.

- Skill: `incidentfox/linear-tasks` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add incidentfox/linear-tasks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/incidentfox/linear-tasks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: incidentfox (https://skillmd.com/u/incidentfox)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/incidentfox/linear-tasks

---


# Linear Issue Tracking

## Authentication

Set the `LINEAR_API_KEY` environment variable with a Linear API key (from Settings > API).

---

## Priority Levels

| Value | Level |
|-------|-------|
| 0 | No priority |
| 1 | Urgent |
| 2 | High |
| 3 | Medium |
| 4 | Low |

---

## Available Scripts

All scripts are in `.claude/skills/linear-tasks/scripts/`

### create_issue.py - Create Issue
```bash
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix bug" [--description "..."] [--priority 2]

# Examples:
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix auth timeout" --description "Users report 504 on login" --priority 2
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Update docs" --team-id TEAM_UUID
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Security review" --priority 1 --labels "security,urgent"
```

### list_issues.py - List/Search Issues
```bash
python .claude/skills/linear-tasks/scripts/list_issues.py [--state "In Progress"] [--max-results 50]

# Examples:
python .claude/skills/linear-tasks/scripts/list_issues.py
python .claude/skills/linear-tasks/scripts/list_issues.py --state "In Progress"
python .claude/skills/linear-tasks/scripts/list_issues.py --state "Todo" --max-results 20
```

---

## Client Library Functions

The `linear_client.py` module provides a GraphQL client:

| Function | Purpose |
|----------|---------|
| `graphql_request(query, variables)` | Execute any GraphQL query against Linear |
| `create_issue(title, description, ...)` | Create a new issue |
| `search_issues(query)` | Search issues by text |
| `get_issue(issue_id)` | Get issue details by identifier |

---

## Common Workflows

### 1. Create a Task from a Conversation

```bash
python create_issue.py --title "Update refund policy docs" \
  --description "Customer asked about refund timeline — docs are outdated" \
  --priority 3
```

### 2. Check Team Workload

```bash
python list_issues.py --state "In Progress"
```

### 3. Find Related Issues

```bash
python list_issues.py --state "Todo" --max-results 100
```

---

## Quick Reference

| Goal | Command |
|------|---------|
| Create issue | `create_issue.py --title "Title" --priority 2` |
| List open issues | `list_issues.py --state "In Progress"` |
| List all issues | `list_issues.py --max-results 100` |