linear

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

94|2|Updated May 11, 2026
One-click install
npx skills add https://github.com/byaan-ai/byaan --skill linear-byaan-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/byaan-ai/byaan/tree/main/server/skills/linear
Command: npx skills add https://github.com/byaan-ai/byaan --skill linear-byaan-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Linear is a powerful platform for managing issues, projects, and cycles, but programmatic control requires interacting with its GraphQL API. This Skill provides a dedicated, end-to-end interface to manage Linear resources, enabling automation, integration with existing tools, and persistent, repeatable workflows.

## Core Features & Use Cases

  • Manage issues, projects, cycles, and teams via the GraphQL API.
  • Create, query, and mutate items with proper ID lookups (teamId, stateId, assigneeId) and support for pagination.
  • Automate common workflows such as issue creation, updates, and state transitions across multiple teams.

### Quick Start Connect Linear with your workspace and fetch the first page of issues.

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 creation and state transitions?

Automate Linear issue creation and state transitions by applying mutations via the GraphQL API endpoint. The Skill performs ID lookups for stateId and teamId before applying workflow changes across multiple teams.

What is the best way to manage Linear projects programmatically?

Manage Linear projects programmatically by sending queries and mutations to the GraphQL API endpoint. The Skill handles retrieving necessary IDs and applying guards to ensure safe project modifications.

Do I need a Linear API key to query and mutate issues?

Yes, querying and mutating Linear issues requires a Linear API key. The Skill uses this key to authenticate requests sent to the single GraphQL endpoint for managing workspace resources.

How does retrieving IDs before mutations work in Linear?

Retrieving IDs before mutations works by querying the Linear GraphQL API for necessary identifiers like teamId, stateId, and assigneeId. The Skill fetches these IDs first to ensure mutations target the correct workspace resources.

Can I use GraphQL pagination to fetch all Linear issues in a workspace?

Yes, you can use GraphQL pagination to fetch Linear issues in a workspace. The Skill supports standard pagination to retrieve sequential pages of issues, projects, and cycles from the API endpoint.