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.