How do I install the Linear skill?

Run npx skillmds@latest add manu14357/linear in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Linear safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linear?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linear free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Linear?

manu14357 (@manu14357) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linear by manu14357 — Agent Skill

Name: Linear
Rating: 4.2 (5 reviews)
Author: manu14357

File contents

Linear Issue Management

Use This Skill When

Creating or updating Linear issues programmatically
Managing projects and team workflows in Linear
Reading issue status and project information
Bulk-updating issues or labels
Assigning work and tracking progress
Organizing sprints and cycles

When NOT to Use

Real-time planning via Linear UI (faster there)
Complex workflow logic beyond CRUD
Issues involving authentication setup

Context: Issue Management Maturity

Undeveloped: Manual UI clicking, slow issue creation.

Target: Programmatic issue creation/update, read project status, manage cycles.

Optimized: Automated workflows, bulk operations, integrated with CI/CD and external systems.

Core Principle

Programmatic issue management scales. Direct API access enables batch operations, automation, and integration that's impossible via UI alone.

Instructions

Step 1: Set Up Linear MCP

If not already configured:

codex mcp add linear --url https://mcp.linear.app/mcp
codex --enable rmcp_client
codex mcp login linear  # OAuth login
# Restart codex after login

Step 2: Clarify Goal and Scope

Determine what you're working with:

Team: Which team owns this work?
Project: Which project are issues in?
Labels: Standard labels in this workspace?
Cycles: Current sprint/cycle?

Step 3: Execute Issue Operations

List issues:

composio execute LIST_ISSUES -d '{
  "team_key": "ENG",
  "status": "todo",
  "limit": 20
}'

Create issue:

composio execute CREATE_ISSUE -d '{
  "team_id": "team-123",
  "title": "Fix login bug",
  "description": "Users report 500 error on login page",
  "priority": 1,
  "estimate": 3
}'

Update issue:

composio execute UPDATE_ISSUE -d '{
  "issue_id": "ENG-123",
  "status": "in_progress",
  "assignee_id": "user-456"
}'

Step 4: Organize Work

Use labels and projects to organize:

Assign to cycles (sprints)
Add labels (bug, feature, tech-debt)
Link related issues
Set priorities

Step 5: Summary and Next Actions

After operations, confirm:

Issues created/updated
Team visibility into work
Cycle assignments

Output

Deliver issue operations summary and any created/updated issues with tracking links.

---name: lineardescription: Manage issues, projects, and team workflows in Linear via the Linear MCP server. Create, update, organize, and track work without leaving the terminal.---# Linear Issue Management## Use This Skill When- Creating or updating Linear issues programmatically- Managing projects and team workflows in Linear- Reading issue status and project information- Bulk-updating issues or labels- Assigning work and tracking progress- Organizing sprints and cycles## When NOT to Use- Real-time planning via Linear UI (faster there)- Complex workflow logic beyond CRUD- Issues involving authentication setup## Context: Issue Management Maturity**Undeveloped**: Manual UI clicking, slow issue creation.**Target**: Programmatic issue creation/update, read project status, manage cycles.**Optimized**: Automated workflows, bulk operations, integrated with CI/CD and external systems.## Core Principle**Programmatic issue management scales.** Direct API access enables batch operations, automation, and integration that's impossible via UI alone.## Instructions### Step 1: Set Up Linear MCP**If not already configured:**```bashcodex mcp add linear --url https://mcp.linear.app/mcpcodex --enable rmcp_clientcodex mcp login linear # OAuth login# Restart codex after login```### Step 2: Clarify Goal and Scope**Determine what you're working with:**- **Team**: Which team owns this work?- **Project**: Which project are issues in?- **Labels**: Standard labels in this workspace?- **Cycles**: Current sprint/cycle?### Step 3: Execute Issue Operations**List issues:**```bashcomposio execute LIST_ISSUES -d '{ "team_key": "ENG", "status": "todo", "limit": 20}'```**Create issue:**```bashcomposio execute CREATE_ISSUE -d '{ "team_id": "team-123", "title": "Fix login bug", "description": "Users report 500 error on login page", "priority": 1, "estimate": 3}'```**Update issue:**```bashcomposio execute UPDATE_ISSUE -d '{ "issue_id": "ENG-123", "status": "in_progress", "assignee_id": "user-456"}'```### Step 4: Organize Work**Use labels and projects to organize:**- Assign to cycles (sprints)- Add labels (bug, feature, tech-debt)- Link related issues- Set priorities### Step 5: Summary and Next Actions**After operations, confirm:**- Issues created/updated- Team visibility into work- Cycle assignments## Output**Deliver issue operations summary and any created/updated issues with tracking links.**

Frequently asked questions

Linear