---

name: linear-skill description: Read and manage Linear issues, projects, and cycles. Use when the user asks to check Linear, view issues, find tasks, check sprint status, or manage work items. Helps inform daily standups and work planning. allowed-tools: Bash, Read

Linear Skill - Issue & Project Management

Read, search, and manage Linear issues. Access teams, cycles, and projects to inform daily work.

First-Time Setup (~2 minutes)

1. Create a Personal API Key

1. Go to Linear Settings
2. Or: Settings > Account > Security & Access > Personal API keys
3. Click Create key
4. Name it (e.g., "Claude Assistant")
5. Select permissions: Read (minimum), or Read + Write for full access
6. Click Create and copy the key (starts with lin_api_)

2. Save API Key

Create the config file:

Copyecho '{"api_key": "lin_api_YOUR_KEY_HERE"}' > ~/.claude/skills/linear-skill/config.json

Commands

My Issues (Assigned to Me)

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py my-issues [--limit N] [--status STATUS]

Shows issues assigned to you, perfect for daily standup prep.

List Teams

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py teams

Team Issues

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py issues TEAM [--limit N] [--status STATUS] [--priority PRIORITY]

Arguments:

• TEAM - Team key (e.g., ENG, EPO) or team name
• --status / -s - Filter by status: backlog, todo, in_progress, done, canceled
• --priority / -p - Filter by priority: urgent, high, medium, low, none
• --limit / -l - Number of issues (default: 20)

Get Issue Details

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py issue ISSUE_ID

ISSUE_ID can be the issue identifier (e.g., EPO-123) or the UUID.

Current Cycle (Sprint)

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py cycle TEAM

Shows the active cycle/sprint for a team with progress stats.

List Cycles

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py cycles TEAM [--limit N]

Search Issues

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py search "query" [--limit N]

Create Issue

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py create TEAM --title "Title" [--description "Desc"] [--priority PRIORITY] [--status STATUS]

Update Issue Status

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py update ISSUE_ID --status STATUS

List Projects

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py projects [TEAM]

Workflow Examples

Morning Standup Prep

Copy# See what's assigned to you
python3 ~/.claude/skills/linear-skill/linear_skill.py my-issues --status in_progress

# Check current sprint status
python3 ~/.claude/skills/linear-skill/linear_skill.py cycle EPO

Check Team Backlog

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py issues EPO --status todo --priority high

Find Specific Work

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py search "authentication bug"

Quick Issue Creation

Copypython3 ~/.claude/skills/linear-skill/linear_skill.py create EPO --title "Fix login timeout" --priority high

Output

All commands output JSON for easy parsing. Issue output includes:

• identifier - e.g., EPO-123
• title
• status - Current workflow state
• priority - 0 (none) to 1 (urgent)
• assignee - Who it's assigned to
• cycle - Sprint/cycle info if applicable
• labels - Applied labels
• estimate - Story points if set

Status Values

Linear workflow states map to these common statuses:

• backlog - Not yet planned
• todo - Planned but not started
• in_progress - Currently being worked on
• in_review - Under review
• done - Completed
• canceled - Won't do

Priority Values

• urgent (1) - Drop everything
• high (2) - Important
• medium (3) - Normal
• low (4) - Nice to have
• none (0) - No priority set

Requirements

No external dependencies - uses Python standard library only.

Security Notes

• API keys don't expire but can be revoked from Linear settings
• Token stored locally in ~/.claude/skills/linear-skill/config.json
• Revoke access: Settings > Account > Security & Access > Personal API keys

Sources

• Linear API Docs
• GraphQL Reference
• Filtering