linear-claude-skill

Manage Linear issues, projects, and initiatives via MCP tools, CLI, and SDK scripts.

1|Updated Sep 15, 2026
One-click install
npx skills add https://github.com/amoai-tech/mdeai --skill linear-claude-skill-amoai-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-claude-skill
Source: https://github.com/amoai-tech/mdeai/tree/main/.claude/skills/archive/linear/linear-claude-skill
Command: npx skills add https://github.com/amoai-tech/mdeai --skill linear-claude-skill-amoai-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @linear/sdk.

What problem does it solve? This Skill removes the friction of manually managing Linear workspaces by providing structured workflows for creating issues, updating statuses, and linking projects to initiatives without leaving your AI-assisted environment. ## Core Features & Use Cases - Multi-Backend Tooling: Operates through Linear MCP tools, the Linear CLI, or TypeScript helper scripts depending on what is available in your environment. - Project Lifecycle Management: Create projects linked to initiatives, transition states (planned, in-progress, completed), and enforce the rule that every issue belongs to a project and every project to an initiative. - Bulk Operations & Sync: Update statuses across many issues at once and delegate bulk work to a Linear-specialist subagent for parallel execution. - Use Case: When starting a new development phase, create the project, set it to planned, generate parent and sub-issues, and later mark everything done with a few commands instead of dozens of UI clicks. ## Quick Start Ask the assistant to create a Linear issue titled "Fix login redirect" in your current project and set its status to Todo.

Frequently Asked Questions about linear-claude-skill

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

FAQPage Schema
How do I create a Linear issue from the command line?

Use the Linear CLI with 'linear issues create --title "Title" --description "Details"', or run the helper script 'npx tsx scripts/linear-ops.ts create-issue "Project" "Title" "Description"' to place the issue directly in a project.

What should I use when Linear MCP tools are not available?

Fall back to the Linear CLI via Bash for viewing, creating, and updating issues, or use the TypeScript helper scripts for bulk operations. The skill explicitly supports MCP tools, CLI, and SDK scripts as interchangeable backends.

How do I update Linear issue status in bulk?

Run 'npx tsx scripts/linear-ops.ts status Done ENG-101 ENG-102 ENG-103' to update multiple issues at once. For large batches, delegate to the Linear-specialist subagent so updates run in parallel.

How do I keep my Linear API key secure when using scripts?

Use varlock to inject secrets: validate with 'varlock load' and run scripts via 'varlock run -- npx tsx scripts/query.ts'. Never echo LINEAR_API_KEY, print env variables, or run 'linear config show', which would expose the key.

Why must every Linear issue be attached to a project?

Issues without a project do not appear on project boards, and projects without an initiative do not appear on roadmaps. The skill enforces this hierarchy so tracking, metrics, and Linear views remain accurate.