Official agent skill

Linear

by zapier in zapier/connectors

Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles.

OfficialElastic-2.0Auto-check passedProductivity & Automation

Install Linear

skills CLI
$ npx skills add zapier/connectors --skill linear -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zapier/connectors linear --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/linear .claude/skills/linear && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
linear
GitHub stars
176
Used in
1 other repo
Token cost
~5.1k tokens
SKILL.md length
1,856 words
Files
70 (incl. scripts, references)
Skills in repo
30
Repo updated
First seen
Licence
Elastic-2.0

At a glance

Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles.

  • The user mentions Linear
  • SKILL.md covers When to use this, Setup, Scripts and Disambiguation & refusals, plus 3 more sections
  • Runs TypeScript and JavaScript scripts from its folder; calls npm, npx and git; reaches api.linear.app
  • Wants to track issues

What it does

Linear is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles. Use when the user mentions Linear or wants to track issues, even if they don't name Linear explicitly.

Its SKILL.md is about 5.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 73 other files, including scripts and reference files (for example `.claude-plugin/plugin.json`, `.mcp.json` and `CHANGELOG.md`). Compatibility notes: Run npm install --omit=dev in this directory, then node cli.js. The TypeScript source needs Node.js 22.18+; on older Node, run cli.js for build-it-yourself /…

It sits in Productivity & Automation. It works with Zapier. The repository describes itself as: Connect your agent to the apps you already use - with or without Zapier.

When your agent uses it

  • The user mentions Linear
  • Wants to track issues
  • Even if they dont name Linear explicitly

Example prompts

  • “/linear”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.

What it can do on your machine

Read from SKILL.md and the folder at commit e48d26f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (TypeScript and JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • npx
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.linear.app

    Also links to:

    • linear.app
    • agentskills.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.

    From compatibility in the SKILL.md frontmatter.

Context cost

Linear loads about 5.1k tokens when it runs, and up to ~15k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 1,856 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~5.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~15k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Elastic-2.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,856 words (~5,103 tokens).

“Tools for working with Linear over the Linear GraphQL API (POST https://api.linear.app/graphql): create and update issues, comment on them and attach links, find issues by identifier or filter, manage projects and post project updates, and resolve the teams, workflow states…”

— opening of SKILL.md by zapier, Elastic-2.0
name
linear
compatibility
Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
license
Elastic-2.0
metadata.source
https://github.com/zapier/connectors/blob/main/apps/linear/SKILL.md
metadata.title
Linear
metadata.api-docs
https://linear.app/developers/graphql
metadata.zapier-app-key
LinearCLIAPI

Read the full SKILL.md on GitHub

Files

SKILL.md and 69 other files (scripts, references) in apps/linear of zapier/connectors.

  • SKILL.md
  • .claude-plugin/plugin.json
  • .mcp.json
  • CHANGELOG.md
  • LICENSE
  • NOTICE
  • README.md
  • cli.js
  • cli.ts
  • connections.ts
  • evals/evals.json
  • evals/results.md
  • index.ts
  • lib/linearGraphql.ts
  • package.json
  • references/linear-api-gotchas.md
  • references/linear-formatting.md
  • … and 53 more

Open the folder on GitHubat commit e48d26f

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in zapier/connectors, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Linear next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linear compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear this skillzapier/connectors1761 repos~5.1kAutomated safety check: PassElastic-2.0
Zapier SDKzapier/sdk262—~2.9kAutomated safety check: PassMIT
Zapier Demozapier/zapier-mcp428—~2.7kAutomated safety check: PassMIT
Zapier Statuszapier/zapier-mcp428—~1.8kAutomated safety check: PassMIT
Zapier Explorezapier/zapier-mcp428—~4kAutomated safety check: PassMIT
Zapier Onboardzapier/zapier-mcp428—~2.8kAutomated safety check: PassMIT

Similar skills

  • Zapier SDK

    zapier/sdk

    Official

    Zapier SDK for TypeScript. An agent skill from zapier/sdk.

    262 GitHub stars~2.9k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Zapier Demo

    zapier/zapier-mcp

    Official

    Walk a new user through setting up their first Zapier action and running it live — the smallest possible win.

    428 GitHub stars~2.7k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Zapier Status

    zapier/zapier-mcp

    Official

    Check the health of your Zapier MCP setup. An agent skill from zapier/zapier-mcp.

    428 GitHub stars~1.8k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Zapier Explore

    zapier/zapier-mcp

    Official

    Explore what Zapier MCP can do for the user — interview them about their role and the apps they live in, suggest specific use cases as on-demand prompts, then walk them through enabling the actions…

    428 GitHub stars~4k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Zapier Onboard

    zapier/zapier-mcp

    Official

    Onboard a new user to Zapier MCP — introduce what it can do, walk through authentication, and route into the right flow based on the state of their setup.

    428 GitHub stars~2.8k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Automation Instructions

    deusXmachina-dev/memorylane

    Write step-by-step automation instructions for a workflow, tailored to your tool (Claude, n8n or Zapier).

    121 GitHub stars~1.1k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from zapier/connectors

All 30 skills in this repo
  • Google Ads

    zapier/connectors

    Official

    Agent-callable Google Ads tools — search campaigns, ad groups, and ads via GAQL, build performance reports, manage campaign status and budgets, and set up conversion tracking.

    176 GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • Alpaca

    zapier/connectors

    Official

    Agent-callable Alpaca trading tools — place and manage stock, crypto, and options orders, read account balances, positions, and portfolio history, look up assets and market hours, and read watchlists.

    176 GitHub stars~4.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Clay

    zapier/connectors

    Official

    Agent-callable Clay tools — create, update, and find rows in Clay tables, and navigate workspaces, tables, views, and users.

    176 GitHub stars~3.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Discord

    zapier/connectors

    Official

    Agent-callable Discord tools — send and manage messages, start threads and forum posts, manage channels, members, and roles, and post via webhooks.

    176 GitHub stars~4.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dropbox

    zapier/connectors

    Official

    Agent-callable Dropbox tools — upload, organize, find, and share files and folders.

    176 GitHub stars~4.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Elevenlabs

    zapier/connectors

    Official

    Agent-callable ElevenLabs tools — generate spoken audio from text, create sound effects and multi-speaker dialogue, re-voice and clean up audio, transcribe audio and video, design synthetic voices…

    176 GitHub stars~3.7k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Linear

What does Linear do?

Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles. Linear is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles.

When should I use Linear?

Linear fits situations like: the user mentions Linear; wants to track issues; even if they dont name Linear explicitly.

How do I install Linear in Claude Code?

Run `npx skills add zapier/connectors --skill linear -a claude-code`. Or copy the skill folder (apps/linear in zapier/connectors) into .claude/skills/linear in your project. Claude Code loads it when a task matches its description.

How do I install Linear in Codex?

Run `npx skills add zapier/connectors --skill linear -a codex`. Or copy the skill folder (apps/linear in zapier/connectors) into .agents/skills/linear in your project. Codex loads it when a task matches its description.

Can I use Linear in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zapier/connectors --skill linear -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linear, .gemini/skills/linear, .github/skills/linear and .opencode/skills/linear in your project.

What does Linear need to run?

Going by SKILL.md and its folder, Linear needs TypeScript and JavaScript for the scripts in its folder and the command-line tools its instructions call (npm, npx and git). Our summary lists: Node.js. Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options..

Does Linear access the network?

SKILL.md names 3 domains. In commands or code: api.linear.app; the agent is likely to contact it when it follows the instructions. As links in the text: linear.app and agentskills.io. This is read from the text; nothing was executed.

Is Linear safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linear use?

Linear is published under the Elastic-2.0 licence (declared in SKILL.md).

How many tokens does Linear use?

About 5.1k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.4k tokens, read only when the agent opens those files.

What are the alternatives to Linear?

Skills that share tags, products or a category with Linear: Zapier SDK (zapier/sdk, 262 stars), Zapier Demo (zapier/zapier-mcp, 428 stars), Zapier Status (zapier/zapier-mcp, 428 stars) and Zapier Explore (zapier/zapier-mcp, 428 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear?

zapier (a GitHub organization, an official publisher) maintains it in zapier/connectors, which has 176 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on August 25, 2026.

Source: zapier/connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.