linear

Execute single GraphQL operations against Linear within Symphony app-server sessions.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/airhorns/jam --skill linear-airhorns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/airhorns/jam/tree/main/.agents/skills/linear
Command: npx skills add https://github.com/airhorns/jam --skill linear-airhorns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often need to perform raw GraphQL queries and mutations against Linear within a Symphony app-server session. This can be error-prone and time-consuming when editing comments, uploading assets, or exploring the API without tooling.

Core Features & Use Cases

  • Execute a single GraphQL operation per call to keep requests focused and predictable.
  • Support targeted introspection to discover mutations, inputs, and fields without leaving the tool.
  • Error handling surfaces top-level errors arrays so failed operations are clearly surfaced.
  • Narrow payloads by requesting only the needed fields for efficient workflows.
  • Common workflows include querying issues by key, mutating comments, and creating attachments or uploads via GraphQL.

Quick Start

Launch a Symphony app-server session and call linear_graphql with a query and optional variables to execute a GraphQL operation against Linear.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I run raw GraphQL queries and mutations against Linear?

Run raw GraphQL queries and mutations against Linear by executing a single GraphQL operation per call within a Symphony app-server session. You provide a query and optional variables to fetch issues, mutate comments, or upload assets with structured input and error handling.

Can I discover available fields and mutation types in the Linear API without external tooling?

Yes, you can discover available fields and mutation types in the Linear API using targeted GraphQL introspection. This built-in introspection capability allows you to explore necessary mutations, inputs, and fields directly during your session without switching to external API exploration tools.

How do I handle errors when executing Linear GraphQL mutations?

Error handling for Linear GraphQL mutations surfaces top-level errors arrays from failed operations. When a request fails, the system clearly surfaces these top-level errors, allowing you to identify exactly what went wrong during your comment edits, uploads, or issue queries.

Does the Linear GraphQL integration support uploading assets and creating attachments?

Yes, the Linear GraphQL integration supports uploading assets and creating attachments. You can automate these workflows alongside fetching issues by key and mutating comments by executing a single GraphQL operation per call with structured input.

What is the limitation when sending GraphQL requests to Linear?

The primary limitation when sending GraphQL requests to Linear is that it enforces one operation per call. You must narrow payloads by requesting only the needed fields to keep requests focused and predictable across your API automation workflows.

Do I need a Symphony app-server session to automate Linear API workflows?

Yes, you need a Symphony app-server session to automate Linear API workflows. Launching a session provides the environment required to call the GraphQL endpoint with your query and optional variables to execute operations like fetching issues or editing comments.