Does this require a specific API token?

Yes, you will need a Linear API token (starting with lin_api_) included in the authorization headers to perform any operations via this skill.

Can I search for specific issues by their identifier?

Yes, it provides GraphQL queries to filter issues by number and identifier to ensure accurate matching even when multiple teams are present in a workspace.

Can I upload screenshots to Linear using this skill?

Yes, the skill includes a detailed three-step workflow for uploading files using Google Cloud Storage signed URLs and the Linear API, including required header management.

How does the skill handle Linear labels?

Since Linear lacks a dedicated 'add label' mutation, this skill provides patterns to update labels by fetching existing ones and submitting a revised array of IDs.

Is the Python SDK or raw GraphQL recommended?

For complex tasks like file uploads, variables, or specific field support like 'estimate', raw GraphQL is recommended as the current Python SDK has significant limitations.

Linear Project Management

Name: Linear Project Management
Author: WarrenZhu050413

byWarrenZhu050413

•

Collaboration Tools

Integrates Linear project management capabilities into Claude Code workflows via GraphQL and Python SDK best practices.

This skill empowers Claude to interact directly with the Linear project management system, enabling automated issue creation, status updates, and complex file uploads. It provides a comprehensive set of patterns for using the Linear GraphQL API and the linear-py SDK, offering specific guidance on overcoming common pitfalls like label management and the multi-step Google Cloud Storage file upload process. It is ideal for developers looking to automate ticket workflows, sync project progress, or manage issues directly from their terminal or coding environment.

Key Features

01Advanced issue searching and filtering by identifier or number

02Automated file and screenshot upload workflow with GCS signed URLs

03Detailed patterns for status, label, and due date management

045 GitHub stars

05Full GraphQL API integration for advanced issue manipulation

06Streamlined Python SDK patterns for basic read/write operations

Use Cases

01Syncing Linear tickets with external CI/CD or local development workflows

02Automating issue creation from code analysis or bug reports

03Updating project status and attaching logs or screenshots programmatically

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add warrenzhu050413/warren-claude-code-plugin-marketplace using-linear

For use in Claude.ai and ChatGPT

Download Skill