linear

Automate Linear issues, projects, and teams via GraphQL curl calls.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill linear-john-data-chen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/john-data-chen/hermes-agent-backup/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill linear-john-data-chen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linear workflow management often requires repetitive UI actions to fetch, create, or update items across issues, projects, and teams. This Skill enables automated interactions with Linear's GraphQL API via curl, reducing manual steps and enabling repeatable workflows.

Core Features & Use Cases

  • Issue management: create, update, query, and list issues across multiple teams.
  • Project and team queries: retrieve teams, projects, and their associated states and metadata.
  • Automation-ready workflows: script common routines such as status checks or data retrieval to fit weekly schedules.

Quick Start

Authenticate with your LINEAR_API_KEY and issue a GraphQL POST to https://api.linear.app/graphql to fetch viewer 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 GraphQL and curl?

Automate Linear issue management by sending POST requests with JSON payloads to https://api.linear.app/graphql using curl. You can create, update, query, and list issues across multiple teams by executing GraphQL mutations and queries.

Do I need a LINEAR_API_KEY to automate workflows with curl?

Yes, you need a LINEAR_API_KEY environment variable to authenticate curl requests. You must include this API key in your POST requests to the Linear GraphQL endpoint to successfully query states, list teams, or retrieve project data.

Can I retrieve Linear teams and project metadata via GraphQL?

Yes, you can retrieve Linear teams and project metadata by sending GraphQL queries via curl POST requests. The API returns associated states and project data across your Linear workspace for automation-ready workflows and status checks.

What's the best way to script repetitive Linear workflow operations?

The best way to script repetitive Linear operations is using curl to send GraphQL queries and mutations to the Linear API. This approach reduces manual UI steps and enables repeatable workflows for creating issues, updating projects, and retrieving data.

How does Linear's GraphQL API handle issue creation and updates?

Linear's GraphQL API handles issue creation and updates through GraphQL mutations sent as JSON payloads via curl POST requests. You can create new issues, update existing ones, and query their current states across multiple teams in your Linear workspace.