linear-connector

Retrieve and manage Linear issues, projects, teams, comments, and attachment links.

10|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/narailabs/narai-primitives --skill linear-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-connector
Source: https://github.com/narailabs/narai-primitives/tree/main/plugins/linear-connector/skills/linear-connector
Command: npx skills add https://github.com/narailabs/narai-primitives --skill linear-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users find, explain, and safely manage work in Linear by routing read and write actions through a policy gate before any network call is made.

Core Features & Use Cases

  • Issue discovery and details: Search issues and retrieve project, team, and issue-specific comments and attachments for fast context gathering.
  • Write operations with guardrails: Create, update, archive issues; add, update, and delete comments; and link external attachment URLs to issues.
  • Policy-gated execution: Read actions succeed by default, write and delete actions escalate by default, and privilege actions are hard-denied to enforce operator safety requirements.
  • Markdown-native content: Create or update descriptions and comment bodies using plain markdown strings without ADF conversion.

Quick Start

Use linear-connector to search issues in a Linear team by asking: "Find the most recent open bugs matching 'login' in team ENG, returning up to 20 results."

Frequently Asked Questions about linear-connector

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

FAQPage Schema
How do I search Linear issues and retrieve project details safely?

You can search Linear issues and retrieve project, team, comment, and attachment details by routing read requests through a policy gate that allows reads by default before executing any GraphQL call.

How do I create and update Linear issues using markdown?

Create and update Linear issues by passing plain markdown strings for descriptions and comments without ADF conversion, routing write actions through a policy gate that escalates write operations by default for safety.

Can I link externally hosted files to Linear issues?

Yes, you can link externally hosted file attachment URLs to Linear issues using the write workflow, which applies policy enforcement to escalate the action before updating the issue.

How does policy enforcement work for Linear issue updates?

Policy enforcement for Linear updates allows read actions by default, escalates write and delete actions like archiving issues or updating fields, and hard-denies privilege actions before any network call is made.

What are the limitations when managing Linear comments and attachments?

Limitations include the hard denial of privilege actions and the enforcement of policy escalation for all write and delete operations, meaning you cannot bypass the policy gate to add, update, or delete comments.

Do I need a specific environment to manage Linear workflows with policy safety?

You must invoke the linear-connector binary with a specified action and JSON parameters, ensuring your environment supports executing this binary to enforce policy gates before making Linear GraphQL calls.