linear-issues

Create, search, filter, paginate, and update Linear issues via GraphQL API.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/theslashdojo/dojo --skill linear-issues-theslashdojo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-issues
Source: https://github.com/theslashdojo/dojo/tree/main/nodes/linear/issues
Command: npx skills add https://github.com/theslashdojo/dojo --skill linear-issues-theslashdojo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @linear/sdk, and includes scripts (resource) components.

What problem does it solve?

Enable teams and agents to programmatically create, search, filter, update, and triage issues in Linear so that manual ticket handling, repetitive triage, and cross-system sync tasks are automated and reliable.

Core Features & Use Cases

  • Create issues with full metadata (title, description, priority, assignee, labels, project, cycle).
  • Search and list issues with GraphQL filters and Relay-style pagination for triage and reporting.
  • Update issue state, assignee, priority, labels, and relationships to support sprint planning, bug filing from CI, and status syncs with external systems.
  • Includes ready-to-run TypeScript scripts for listing, searching, creating, and updating issues to accelerate automation workflows.

Quick Start

Use the create script to file a new Linear issue for team ENG titled Bug: login fails on Safari and set its priority to High.

Frequently Asked Questions about linear-issues

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

FAQPage Schema
How do I automate Linear issue creation and triage using the GraphQL API?

Automate Linear issue triage by using the @linear/sdk TypeScript client to execute GraphQL queries and mutations, allowing you to programmatically create, search, and update issues with full metadata like priority and assignee.

Can I use the @linear/sdk to filter and paginate issues for sprint planning?

Yes, you can use the @linear/sdk to filter and list Linear issues for sprint planning by applying GraphQL filters and utilizing Relay-style pagination to manage large sets of search results.

What is the best way to automatically file bugs to Linear from a CI pipeline?

Automatically file bugs to Linear from CI pipelines by running TypeScript scripts that use the @linear/sdk to create issues with predefined titles, descriptions, and priorities directly within your automated workflows.

Do I need a Linear API key to programmatically update issue states and assignees?

Yes, you need a Linear API key to authenticate requests when using the @linear/sdk to programmatically update issue states, assignees, priorities, labels, and relationships for status syncing and sprint management.

How does Relay-style pagination work when searching and listing Linear issues?

Relay-style pagination in Linear issue searches uses GraphQL cursors to fetch sequential pages of filtered issues, enabling efficient traversal and reporting of large issue datasets without overwhelming the API response limits.

Are there limitations to automating Linear issue lifecycle management via the GraphQL API?

Limitations of Linear issue automation via the GraphQL API include rate limits on API requests and the necessity of maintaining valid authentication credentials when running TypeScript scripts for continuous issue updates and triage.