Linear

Coordinate Linear issues, projects, and teams across MCP, SDK, and GraphQL interfaces.

120|13|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/wrsmith108/linear-claude-skill --skill linear-wrsmith108
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Linear
Source: https://github.com/wrsmith108/linear-claude-skill/tree/main/skills/linear
Command: npx skills add https://github.com/wrsmith108/linear-claude-skill --skill linear-wrsmith108

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a unified framework to automate Linear-based workflows, including creating and updating issues and projects, querying data via MCP, SDK, and GraphQL, and syncing state across initiatives.

Core Features & Use Cases

  • MCP Tools: Perform quick create/read/update tasks for issues and projects with reliable patterns.
  • SDK Automation: Leverage TypeScript scripts for complex workflows, loops, and bulk updates.
  • GraphQL API: Use direct API access as a fallback for advanced queries not supported by MCP/SDK.
  • Bulk Sync: Synchronize code changes and project status across issues and initiatives in one workflow.
  • Resource & Output Management: Maintain linked initiatives, milestones, and updates to reflect progress.

Quick Start

Run a quick GraphQL viewer query to test access: LINEAR_API_KEY=your-key npx tsx scripts/query.ts "query { viewer { id name } }"

Frequently Asked Questions about Linear

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

FAQPage Schema
How do I automate creating and updating issues in Linear?

Automate Linear issues using MCP tools for quick create/read/update tasks, or TypeScript SDK scripts for complex workflows. The Skill provides unified access via MCP, SDK, and GraphQL APIs, with fallback to GraphQL when MCP or SDK are insufficient for your use case.

Can I bulk sync issues and projects across Linear workflows?

Yes, bulk sync coordinates Linear issues, projects, and teams across MCP, SDK, and GraphQL interfaces. Use SDK automation for looped batch operations and link projects to initiatives, enabling synchronized state across development, QA, and release workflows.

What's the best way to query Linear data if standard tools don't support my query?

Use direct GraphQL API access as a fallback when MCP or SDK don't support your query. The Skill provides guidance on tool selection and includes chunked/batched operations, error handling, and rate-limiting considerations for advanced queries.

How do I set up Linear SDK automation with TypeScript scripts?

Use the @linear/sdk TypeScript scripts component to leverage complex workflows and bulk updates. Test access first with a GraphQL query: LINEAR_API_KEY=your-key npx tsx scripts/query.ts "query { viewer { id name } }".

Does this work for coordinating issues across multiple teams in Linear?

Yes, the Skill solves coordination of Linear issues, projects, and teams across multiple interfaces. It maintains linked initiatives, milestones, and updates to reflect progress across distributed teams and workflows.

What happens when rate limits or API failures occur during bulk operations?

The Skill includes built-in rate-limiting considerations and fallback patterns to GraphQL when MCP or SDK encounter failures. Batched operations and error handling logic ensure reliable bulk sync across initiatives and projects.