linear

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

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jleechanorg/hermes-agent --skill linear-jleechanorg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/jleechanorg/hermes-agent/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/jleechanorg/hermes-agent --skill linear-jleechanorg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automate Linear workflows by managing issues, projects, and teams through the GraphQL API, removing repetitive manual tasks in project management.

Core Features & Use Cases

  • GraphQL-powered operations for listing, creating, updating issues; managing teams and projects; and reading documents.
  • Includes a lightweight Python helper script (scripts/linear_api.py) for ergonomic one-liners and common workflows.
  • Use cases include automated sprint setup, status updates, cross-team coordination, and programmatic reporting.

Quick Start

Export LINEAR_API_KEY and run the CLI (for example, whoami) to verify access.

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?▼

Automate Linear issue management by executing GraphQL operations to list, create, and update issues through a compact CLI and Python helper script. Results are returned as structured JSON for easy integration into automated workflows.

What do I need to query Linear projects and teams programmatically?▼

Querying Linear projects and teams programmatically requires a valid LINEAR_API_KEY and curl installed in your environment. The Skill provides a Python helper script to execute these queries and return structured JSON.

Can I fetch and read Linear documents via the command line?▼

Yes, you can fetch and read Linear documents via the command line using the included lightweight Python helper script. It executes GraphQL queries to retrieve documents and returns the data as structured JSON.

What is the best way to set up automated sprint workflows in Linear?▼

Automated sprint workflows in Linear are best set up by using the GraphQL API to manage issues, projects, and teams. The Skill's CLI and Python script automate repetitive manual tasks like sprint setup and status updates.

Does this Linear automation CLI require any external dependencies?▼

The Linear automation CLI requires curl to execute API requests and a valid LINEAR_API_KEY for authentication. It includes a Python helper script but relies on these core dependencies to function.

Why use a GraphQL API script for Linear project management instead of manual updates?▼

Using a GraphQL API script for Linear project management removes repetitive manual tasks like cross-team coordination and programmatic reporting. It executes operations like listing and updating issues efficiently, returning structured JSON.