skills.rest
MarbleSodas
MarbleSodasCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

linear

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

Updated Apr 9, 2026
Search Tags:#project management#graphql#issue tracking#api integration#linear#curl#workflow states
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill linear-marblesodas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill linear-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Linear’s issue and project workflows often require lots of repetitive API calls and careful handling of IDs, filters, and workflow state transitions; this Skill streamlines those actions so you can reliably query, create, update, and comment on Linear artifacts.

Core Features & Use Cases

  • Issue & status management via GraphQL: Query teams, projects, workflow states, issues, and move issues between workflow states using the correct stateId.
  • Document management in Linear: List documents, fetch a document by UUID or slugId (from the URL), and search documents by title substring.
  • Two ways to interact: Use direct curl for custom GraphQL queries or a stdlib Python CLI (scripts/linear_api.py) for faster one-liners.

Quick Start

Set LINEAR_API_KEY in your environment and run: python3 scripts/linear_api.py get-issue ENG-42

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 via the GraphQL API?▼

Manage Linear issues via the GraphQL API by sending POST requests to the Linear endpoint with queries for creating, updating, or searching issues and moving them between workflow states.

How do I move a Linear issue between workflow states using an API?▼

Moving Linear issues between workflow states requires updating the issue with the correct target stateId via a GraphQL mutation sent to the Linear API endpoint.

What do I need to query assigned Linear issues through GraphQL?▼

Querying assigned Linear issues requires setting the LINEAR_API_KEY environment variable and executing GraphQL POST requests to the api.linear.app/graphql endpoint for authentication.

Can I fetch Linear documents by slugId or UUID?▼

Fetch Linear documents by slugId or UUID by executing specific GraphQL queries against the Linear API to retrieve document content and list available team documents by title substring.

Does this Linear API integration support curl and Python?▼

The Linear API integration supports both direct curl commands for custom GraphQL queries and a stdlib Python CLI script for executing faster one-liners to manage issues and projects.

What is the best way to automate Linear issue tracking without manual UI clicks?▼

Automate Linear issue tracking by using a stdlib Python CLI to handle repetitive API calls, managing teams, projects, and documents programmatically through deterministic execution scripts.

Related Skills

Explore More Product & Management Skills→
john-data-chenjohn-data-chen
2

linear

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

Community
Intermediate
Kastalien-ResearchKastalien-Research

linear

Manage Linear issues via GraphQL queries with a LINEAR_API_KEY.

Official
Intermediate
hookdeckhookdeck
79

gitlab-webhooks

Receive and verify GitLab webhooks with token authentication.

Official
Intermediate
bendruckerbendrucker
16

linear

Automate Linear issue, project, and team management via MCP, SDK, or GraphQL.

Community
Intermediate