linear

Automate Linear project management via GraphQL operations on issues, comments, and cycles.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dbmcco/claude-agent-toolkit --skill linear-dbmcco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/dbmcco/claude-agent-toolkit/tree/main/skills/linear
Command: npx skills add https://github.com/dbmcco/claude-agent-toolkit --skill linear-dbmcco

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the need to learn Linear's GraphQL API syntax, allowing AI agents to manage project workflows through simple bash scripts.

Core Features & Use Cases

  • Complete Issue Management: Create, update, search, and track issues with full context from conversations.
  • Documentation & Organization: Add comments, labels, attachments, and manage sprint cycles for comprehensive project tracking.
  • Use Case: When discussing a new feature in conversation, use this Skill to automatically create a Linear issue with the full discussion context, assign appropriate labels, and link related resources.

Quick Start

Use the linear skill to create a new issue titled "Implement user authentication" with the description "Based on discussion: Need OAuth2 integration with Google and GitHub providers" and set priority to high.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I automate issue creation in Linear without writing GraphQL queries?

This Skill eliminates GraphQL syntax requirements by exposing bash scripts that execute authenticated GraphQL requests to Linear's API. Create issues, comments, labels, and manage cycles through simple command-line operations sourced from environment variables and JSON parsing.

Can I create Linear issues from conversations and automatically add labels and attachments?

Yes. The Skill transforms conversation context into Linear issues with full description, attachments, and label assignment through bash-based create operations that parse and format JSON results consistently across issue, comment, label, and attachment entities.

What Linear entities can I manage—just issues, or more?

Beyond issues, you can manage comments, labels, cycles, projects, attachments, and query team structure and workflow states. All operations use the same create/list/update/delete CLI pattern backed by GraphQL requests.

Do I need to install additional tools to use this Skill?

Yes. The Skill depends on curl for authenticated HTTP requests and jq for JSON parsing. Both must be available in your environment; the Skill sources credentials from a .env file.

How does this compare to manually managing Linear through the UI or API?

Manual API work requires learning GraphQL syntax and handling authentication. This Skill abstracts both through bash scripts, making it faster for agents and scripts to perform batch operations, link resources, and track sprint cycles without API knowledge.

What happens if my .env file is missing or credentials are invalid?

The bash scripts source environment variables from .env at runtime. Missing or invalid credentials will cause GraphQL requests to fail; ensure your Linear API token is present and valid before executing operations.