linear

Execute raw GraphQL operations against the Linear API.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/ReinaMacCredy/Maestro-CLI --skill linear-reinamaccredy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/ReinaMacCredy/Maestro-CLI/tree/main/.codex/skills/maestro%3Asymphony-setup/reference/codex-skills/linear
Command: npx skills add https://github.com/ReinaMacCredy/Maestro-CLI --skill linear-reinamaccredy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a direct interface to interact with the Linear GraphQL API, enabling complex operations like editing comments, uploading assets, and managing issue states programmatically.

Core Features & Use Cases

  • Raw GraphQL Operations: Execute custom GraphQL queries and mutations against Linear.
  • Comment Management: Create and update comments on Linear issues.
  • Asset Linking: Attach GitHub PRs or other URLs to Linear issues.
  • State Transitions: Programmatically move issues between workflow states.
  • File Uploads: Facilitates uploading files to Linear issues via a multi-step process.

Quick Start

Use the linear_graphql tool to query an issue by its key, such as 'MT-686'.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I run raw GraphQL queries against the Linear API?

You can execute raw GraphQL queries against the Linear API using a client interface that supports custom queries and mutations for retrieving issues by identifier and performing complex operations programmatically.

Can I programmatically link a GitHub PR to a Linear issue?

Yes, you can programmatically link a GitHub PR to a Linear issue by using asset linking operations within the Linear GraphQL API to attach external URLs directly to the issue.

What is the process for uploading files to Linear issues via the API?

Uploading files to Linear issues via the API requires a three-step process facilitated by the GraphQL interface, ensuring assets are properly attached to the target issue through multi-step mutations.

How do I manage Linear issue states and comments programmatically?

You manage Linear issue states and comments programmatically by executing GraphQL mutations to create, update, or transition issues between workflow states directly through the API interface.

Does the Linear GraphQL client support schema introspection?

Yes, the Linear GraphQL client supports schema introspection patterns, allowing you to perform schema discovery to understand available types, fields, and operations before executing raw queries.