linear

Manage Linear issues and projects via GraphQL queries and mutations with curl.

Updated May 5, 2026
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill linear-z43l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/Z43L/zeus-agent --skill linear-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linear issues, projects, and team workflows are difficult to manage at scale through the UI, especially when you want repeatable, scriptable updates.

Core Features & Use Cases

  • Issue & Project Management via GraphQL: Create issues, update state/priority/assignees, manage labels, and add comments directly using Linear’s GraphQL API with curl.
  • Workflow-State Driven Status Updates: Move issues through team-specific workflow state types by resolving the correct stateId first (e.g., backlog, started, completed).
  • Search, Filtering & Pagination: Query teams, workflow states, list/search issues, and handle Relay-style cursor pagination for predictable data retrieval.

Quick Start

Create a Linear personal API key, set LINEAR_API_KEY in your environment, and run a GraphQL query or mutation with curl to list your teams or fetch an issue by identifier like ENG-123.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I automate Linear issue management using the GraphQL API?

Automate Linear issue management by sending GraphQL queries and mutations via curl to the Linear API endpoint. You can script operations like creating issues, updating priority, and adding comments using a POST JSON payload.

How do I move a Linear issue to a new workflow state with curl?

To move a Linear issue to a new workflow state, query your team's workflow states to find the correct stateId, then send a GraphQL mutation via curl to update the issue with that specific stateId.

How do I handle Relay-style pagination when searching Linear issues?

Handle Relay-style pagination in Linear by using the `first` and `after` cursor parameters in your GraphQL queries. This retrieves predictable batches of issue data from the Linear API endpoint over curl.

What do I need to authenticate curl requests to the Linear GraphQL API?

Authenticating Linear GraphQL API requests requires setting the `LINEAR_API_KEY` environment variable and passing it as an authorization header in your curl command.

Can I batch create and update Linear projects and labels without the UI?

Yes, you can batch manage Linear projects and labels without the UI by scripting GraphQL mutations with curl. This allows repeatable, automated updates to team workflows and issue tracking at scale.