Using Linear

Automate Linear issue management via the GraphQL API.

7|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/WarrenZhu050413/Warren-Claude-Code-Plugin-Marketplace --skill using-linear-warrenzhu050413
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Using Linear
Source: https://github.com/WarrenZhu050413/Warren-Claude-Code-Plugin-Marketplace/tree/main/claude-context-orchestrator/snippets/local/documentation/using-linear
Command: npx skills add https://github.com/WarrenZhu050413/Warren-Claude-Code-Plugin-Marketplace --skill using-linear-warrenzhu050413

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates the manual overhead of managing Linear issues, comments, and file uploads, freeing you to concentrate on strategic work.

Core Features & Use Cases

  • Issue Management: Programmatically create, update, and search Linear issues with full GraphQL control.
  • File Upload Automation: Seamlessly upload screenshots and documents to issues with proper Google Cloud Storage header handling.
  • Use Case: Imagine you have daily bug reports from automated testing. Use this Skill to automatically create Linear issues for each bug, attach relevant screenshots, and assign them to the appropriate team members.

Quick Start

Use the Linear skill to search for issue UNIFIED-26 and add a comment with the latest test results.

Frequently Asked Questions about Using Linear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate creating and updating Linear issues programmatically?

Automate Linear issue creation and updates using the GraphQL API or Python SDK. You can programmatically create issues, modify statuses, set due dates, add labels, and search across teams without manual intervention.

Can I upload files and screenshots directly to Linear issues?

Yes, upload files and screenshots to Linear issues using Google Cloud Storage signed URLs with proper header handling. The Skill manages authenticated requests and GCS integration for seamless file attachment automation.

What's the best way to integrate Linear with automated testing workflows?

Use GraphQL queries to automatically create Linear issues from test results, attach screenshots via GCS signed URLs, and post comments with test data. This eliminates manual bug report entry and routes issues to appropriate team members.

Do I need to write raw GraphQL queries to automate Linear workflows?

No. The Skill supports both raw GraphQL and the Python SDK, so you can choose your preferred approach—direct API control or SDK convenience—depending on your workflow complexity and team expertise.

How do I search for and filter Linear issues across multiple teams?

Search across teams using GraphQL queries through the Skill. You can retrieve specific issues by key, filter by status or labels, and perform complex searches to support cross-team automation and reporting.

What authentication is required to connect to Linear's GraphQL API?

Authenticated GraphQL requests require Linear API credentials. The Skill handles token-based authentication for secure API access, enabling programmatic issue management and file upload operations.