Skip to content
Productivity
Skill

/linear-api

Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.

BOOST
From plugin
linear-cli
13838 skills
Install
$ npx -y skills add nesszer/linear-cli --skill linear-api --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/linear-api

Context preview

The summary Claude sees to decide when to auto-load this skill.

Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.

SKILL.md

linear-api.SKILL.md
name: linear-api
description: Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.
allowed-tools: Bash

Raw GraphQL API

# Run a query
linear-cli api query '{ viewer { id name email } }'

# Query with variables
linear-cli api query -v teamId=abc '{ team(id: $teamId) { name } }'

# Run a mutation
linear-cli api mutate -v title="Bug" '
  mutation($title: String!) {
    issueCreate(input: { title: $title, teamId: "..." }) {
      issue { id identifier }
    }
  }
'

# Pipe query from file
cat query.graphql | linear-cli api query -

Flags

| Flag | Purpose | |------|---------| | `-v key=val` | GraphQL variables | | `--output json` | JSON output | | `--compact` | Compact JSON |

Exit Codes

`0`=Success, `1`=Error, `2`=Not found, `3`=Auth error

Ships withlinear-cli

A fast, comprehensive command-line interface for Linear built in Rust. Manage issues, projects, cycles, sprints, documents, and more -- entirely from your terminal.

Get the whole plugin

Other skills on linear-cli.