linear

Manage Linear issues, projects, and documents via GraphQL queries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Linear helps teams manage issues, projects, and documents via a GraphQL API using a lightweight CLI/HTTP approach, reducing manual wrangling with the Linear API.

Core Features & Use Cases

  • GraphQL-driven admin of Linear issues, projects, and teams via curl or the provided Python helper script.
  • Python helper script (linear_api.py) with no dependencies to quickly query viewer, projects, issues, and documents.
  • Document access: list, fetch, and view documents by slugId or UUID; supports content and contentState fields.
  • Support for listing teams, workflows, issues with filters, and updating issues and statuses.

Quick Start

Authenticate with LINEAR_API_KEY and run the Python CLI to interact with your Linear workspace.

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

You can manage Linear issues and projects via GraphQL by using a lightweight CLI or curl commands to query and mutate workspace data. This approach covers querying teams, projects, issues, and documents directly through authenticated HTTP requests.

What do I need to authenticate GraphQL queries for Linear issues?▼

To authenticate GraphQL queries for Linear issues, you need a Linear personal API key stored in the LINEAR_API_KEY environment variable. You then use curl or a Python helper script to execute authenticated API calls against your workspace.

Can I fetch Linear documents using a GraphQL API?▼

Yes, you can fetch Linear documents using GraphQL API queries by specifying the slugId or UUID. The query supports retrieving document content and contentState fields to view full document details from your workspace.

What's the best way to automate Linear workflow updates without heavy dependencies?▼

The best way to automate Linear workflow updates without heavy dependencies is using a zero-dependency Python helper script. It executes GraphQL mutations to create, update issues, and change workflow states via curl or native HTTP calls.

Does the Linear GraphQL API support listing teams and workflow states?▼

Yes, the Linear GraphQL API supports listing teams and workflow states using specific query operations. You can retrieve all teams, workflows, and filter issues by workflow states through authenticated curl or Python CLI requests.