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

•

协作工具

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.

主要功能

Advanced issue searching and filtering by identifier or number
Automated file and screenshot upload workflow with GCS signed URLs
Detailed patterns for status, label, and due date management
5 GitHub stars
Full GraphQL API integration for advanced issue manipulation
Streamlined Python SDK patterns for basic read/write operations

使用场景

Syncing Linear tickets with external CI/CD or local development workflows
Automating issue creation from code analysis or bug reports
Updating project status and attaching logs or screenshots programmatically

关于

主要功能

Advanced issue searching and filtering by identifier or number
Automated file and screenshot upload workflow with GCS signed URLs
Detailed patterns for status, label, and due date management
5 GitHub stars
Full GraphQL API integration for advanced issue manipulation
Streamlined Python SDK patterns for basic read/write operations

使用场景

Syncing Linear tickets with external CI/CD or local development workflows
Automating issue creation from code analysis or bug reports
Updating project status and attaching logs or screenshots programmatically