linear

Query Linear issues and teams via GraphQL with curl requests.

1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill linear-changzhou-xj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/ChangZhou-xj/zxj_skill/tree/main/productivity/linear
Command: npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill linear-changzhou-xj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linear exposes a GraphQL API to manage issues, projects, and teams, enabling automation to replace repetitive manual API work and keep data in sync.

Core Features & Use Cases

  • GraphQL-driven control: query viewer, teams, issues, and perform mutations to create or update items from scripts.
  • CLI-friendly automation: integrate with curl-based workflows in CI, dashboards, or onboarding tooling.
  • Flexible data access: support both UUIDs and short IDs (e.g., ENG-123) for referencing items across teams.

Quick Start

Run a curl POST to the Linear GraphQL endpoint with your LINEAR_API_KEY to retrieve the current user information and basic project data.

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?

You can automate Linear issue management by running curl-based POST requests to the Linear GraphQL endpoint. This Skill executes standard GraphQL queries and mutations to programmatically create, update, and retrieve issues and projects.

Do I need a LINEAR_API_KEY to query issues and teams via curl?

Yes, you need a LINEAR_API_KEY available in your environment. This Skill requires supplying the API key, GraphQL endpoint, and appropriate queries to authenticate and access viewer, teams, and issue data.

Can I use short IDs like ENG-123 to reference Linear issues in GraphQL queries?

Yes, Linear GraphQL queries support flexible data access using both UUIDs and short IDs like ENG-123. This allows you to easily reference and manage specific items across different teams within your automation scripts.

What's the best way to create and update Linear projects from a CLI environment?

The best way to create and update Linear projects from a CLI is using curl-based GraphQL mutations. This Skill provides CLI-friendly automation to perform common mutations, enabling integration into CI workflows or dashboards.

Does this Linear GraphQL Skill support standard pagination for retrieving large sets of issues?

Yes, this Skill supports standard pagination when querying Linear issues via GraphQL. You can retrieve large datasets efficiently by supplying appropriate pagination parameters in your curl-based GraphQL queries.