Linear

Linear Skill

Issue tracking and project management through the Linear GraphQL API.

Installation

skill install ./examples/wasm-skills/linear-skill

Configuration

skill config linear --set LINEAR_API_KEY=lin_api_xxxxx

Get your API key from Linear Settings > API > Personal API keys.

Tools

list-issues

List issues with filtering options.

Parameters:

• team (optional, string): Team key or ID
• project (optional, string): Project name or ID
• status (optional, string): Status: backlog, todo, in_progress, done, cancelled
• assignee (optional, string): Assignee email or ID
• limit (optional, number): Maximum results (default: 50)

Example:

skill run linear list-issues --team ENG --status in_progress

get-issue

Get detailed information about a specific issue.

Parameters:

• id (required, string): Issue ID (e.g., ENG-123)

Example:

skill run linear get-issue --id ENG-123

create-issue

Create a new issue.

Parameters:

• title (required, string): Issue title
• team (required, string): Team key
• description (optional, string): Issue description
• priority (optional, number): Priority (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low)
• assignee (optional, string): Assignee email
• labels (optional, string): Comma-separated label names
• estimate (optional, number): Point estimate

Example:

skill run linear create-issue --title "Fix login bug" --team ENG --priority 2

update-issue

Update an existing issue.

Parameters:

• id (required, string): Issue ID
• title (optional, string): New title
• description (optional, string): New description
• status (optional, string): New status
• priority (optional, number): New priority
• estimate (optional, number): Point estimate

Example:

skill run linear update-issue --id ENG-123 --priority 1 --status in_progress

add-comment

Add a comment to an issue.

Parameters:

• issue_id (required, string): Issue ID
• body (required, string): Comment content (Markdown supported)

Example:

skill run linear add-comment --issue_id abc123 --body "Fixed in latest commit"

list-projects

List projects in a team.

Parameters:

• team (optional, string): Team key
• status (optional, string): Filter: planned, started, paused, completed, cancelled

Example:

skill run linear list-projects --team ENG --status started

list-cycles

List cycles (sprints) for a team.

Parameters:

• team (required, string): Team key
• filter (optional, string): Filter: current, upcoming, past

Example:

skill run linear list-cycles --team ENG --filter current

list-teams

List all teams in the workspace.

Parameters: None

Example:

skill run linear list-teams

Use Cases

Sprint Planning

# View current cycle
skill run linear list-cycles --team ENG --filter current

# List backlog items
skill run linear list-issues --team ENG --status backlog

# Create new issue for sprint
skill run linear create-issue --title "Implement feature X" --team ENG --estimate 3

Daily Standup

# Check in-progress issues
skill run linear list-issues --team ENG --status in_progress

# Get details on blocked issue
skill run linear get-issue --id ENG-456

# Add status update
skill run linear add-comment --issue_id abc123 --body "Waiting on API review"

Project Tracking

# List active projects
skill run linear list-projects --status started

# View project issues
skill run linear list-issues --project "Q1 Release"