linear

Create, update, and search Linear issues via the GraphQL API.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/eddielueng/hermes-agent-zh --skill linear-eddielueng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/eddielueng/hermes-agent-zh/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/eddielueng/hermes-agent-zh --skill linear-eddielueng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linear issue and project management often requires repetitive UI work for creating, searching, updating status, and organizing work items, which slows teams down and makes routine updates hard to automate.

Core Features & Use Cases

  • Create and update issues/projects via GraphQL: Create issues, set status, assign owners, set priority, add labels, set due dates, and add comments.
  • Search and filter with Relay-style pagination: Find issues by text, list teams, projects, members, labels, and narrow results by state type, team, or assignee.
  • No OAuth and minimal tooling: Use API key authentication and run all operations with curl and JSON formatting tools.

Quick Start

Ask the assistant to show the exact curl GraphQL query to list the first 20 issues assigned to you using your LINEAR_API_KEY.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I create and update Linear issues using the GraphQL API?

You can create and update Linear issues by sending curl POST requests with JSON payloads to the Linear GraphQL API. This approach supports setting issue status, assigning owners, changing priorities, adding labels, and posting comments.

How does Linear GraphQL API pagination work for searching issues?

Linear GraphQL API pagination uses Relay-style pagination to search and filter issues. You can query for work items by text and narrow results by state type, team, or assignee, listing teams, projects, members, and labels.

Do I need OAuth to automate Linear issue tracking workflows?

Linear issue tracking automation does not require OAuth. You can authenticate using a Linear API key passed via the Authorization header using LINEAR_API_KEY, enabling deterministic execution with curl and JSON formatting tools.

What's the best way to automate backlog triage and status transitions in Linear?

Automating backlog triage and status transitions in Linear is best handled through GraphQL API curl POST requests. This method allows deterministic execution for priority changes, assignment, labeling, and project membership updates.

Can I use curl to manage Linear projects without additional dependencies?

Yes, you can manage Linear projects with curl and JSON formatting tools without additional dependencies. The workflow relies on API key authentication and GraphQL queries to handle issue creation, updates, and searches with minimal tooling.

What are the limitations of using curl and GraphQL for Linear issue management?

Using curl and GraphQL for Linear issue management requires manual query construction for complex operations and relies on API key authentication. Operations are limited to supported GraphQL mutations and Relay-style pagination constraints for filtering results.