linear

Manage Linear issues, projects, and teams via GraphQL API requests.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/musical-basics/hermes-build-2 --skill linear-musical-basics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/musical-basics/hermes-build-2/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/musical-basics/hermes-build-2 --skill linear-musical-basics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes friction when managing issues, projects, and team workflows in Linear by providing ready-to-use GraphQL queries and curl patterns so users can list, search, create, and update issues without building a custom client.

Core Features & Use Cases

  • Issue Management: Create, update, assign, set priority, add labels, and comment on issues.
  • Project & Team Operations: List projects, teams, and team members; add issues to projects and adjust assignees.
  • Workflow State Handling: Query workflow states to obtain state UUIDs and change issue statuses reliably.
  • Pagination and Filtering: Relay-style cursor pagination, complex filters, and text search for scalable listing and reporting.
  • Use Case: A product manager can query team workflow states, search for blocked issues, update priorities, and add comments using simple curl POST requests.

Quick Start

Use the linear skill to list the first 20 issues for a given team key and display their identifiers, titles, priority, and state.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I manage Linear issues and projects via the API?

You need a Linear personal API key stored in the LINEAR_API_KEY environment variable. The skill sends authorized JSON POST requests directly to the Linear GraphQL endpoint using this key.

How do I change Linear issue workflow states using GraphQL?

Query workflow states via the Linear GraphQL API to obtain the necessary state UUIDs. You then use these UUIDs in your curl requests to reliably change issue statuses and update workflow states.

Can I search and filter Linear issues with curl requests?

Yes, you can search and filter Linear issues using complex filters and text search in your GraphQL queries. The skill supports Relay-style cursor pagination for scalable listing and reporting.

What do I need to start making Linear GraphQL API requests?

Use the skill to list the first 20 issues for a specific team key by running a simple curl POST request. It displays issue identifiers, titles, priorities, and current states.

How do I list team projects and members in Linear via GraphQL?

List team projects and members by executing GraphQL queries through curl POST requests. This allows you to retrieve team data, add issues to projects, and adjust assignees directly.

What is the best way to automate Linear issue creation without a custom client?

Use pre-built curl patterns to send GraphQL mutations to the Linear API for issue creation. This removes friction by letting you create, assign, and label issues using standard command-line tools.