linear

List, search, create, and update Linear issues via GraphQL.

12.6k|1.5k|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/nearai/ironclaw --skill linear-nearai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/nearai/ironclaw/tree/main/skills/linear
Command: npx skills add https://github.com/nearai/ironclaw --skill linear-nearai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the overhead of repeatedly figuring out which Linear user is you by providing cached identity for deterministic “my issues” and “assigned to me” queries, then wraps common issue operations into consistent GraphQL workflows.

Core Features & Use Cases

  • Identity bootstrap & caching: Uses context/intel/linear-identity.md to avoid wasteful viewer round-trips and to make “assignee equals cached user” filters reliable.
  • Core issue workflows: List issues, list issues assigned to the current user, search, fetch by identifier, create, and update issue state via Linear’s GraphQL API.
  • Team-safe issue creation: Retrieves teams when needed to map human team names to teamId, and falls back to a cached default team for creation in “my team”.

Quick Start

Ask your assistant to list your Linear issues for the most recently updated 20 items.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I search and list my assigned Linear issues using GraphQL?

You can list your assigned Linear issues by querying the Linear GraphQL endpoint with assignee filters. This Skill uses cached identity to deterministically filter issues assigned to the current user, avoiding redundant viewer round-trips.

How do I create Linear issues for a specific team via the GraphQL API?

To create Linear issues for a team, the workflow retrieves available teams to map human team names to teamId values. It falls back to a cached default team for my team issue creation, submitting POST requests to api.linear.app/graphql.

What is the best way to update Linear issue states programmatically?

Updating Linear issue states programmatically is done by sending GraphQL mutation requests to the Linear API. This workflow handles state transitions safely by parsing GraphQL errors and authentication failures during the POST request execution.

Does this Linear issue tracking workflow require authentication setup?

Yes, interacting with the Linear GraphQL endpoint requires authentication. The workflow includes error-safe handling for authentication failures and uses a cached identity file to bootstrap your viewer profile for reliable assignee filtering.

Why does my Linear GraphQL query fail to filter issues assigned to me?

Filtering issues assigned to you fails when the viewer identity is not cached or authenticated. This Skill resolves that by bootstrapping identity into a local cache, ensuring subsequent assignee-equals-cached-user GraphQL queries execute deterministically.

Can I fetch a specific Linear ticket by its identifier through GraphQL?

Yes, fetching a specific Linear ticket by its identifier is a core issue workflow supported here. The Skill sends a targeted GraphQL request to api.linear.app/graphql to retrieve the exact issue details safely.