linear Skill (openai) for Codex: What It Does and How to Install It

Makes Codex read, create and update Linear issues, projects and comments through the Linear MCP server.

Installs: 10.6K; on skills.sh
Stars: 28.4K; on GitHub
Files: 4; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill gives Codex a fixed routine for working in Linear: confirm what you want, read first, then create or update, then summarize. It works through the Linear MCP server, which SKILL.md lists as providing issue, project, document, comment and cycle tools.

It triggers when you want to read, create or update tickets in Linear. If the Linear MCP server is not connected, the skill pauses and walks you through connecting it with Codex commands and a Linear OAuth sign-in.

This skill is not by Linear. It is published by OpenAI in the openai/skills repo, which the repo README now marks as deprecated. Linear's own MCP server is covered on our Linear MCP server page.

Good for

Engineers triaging and updating Linear tickets
Team leads planning sprints and releases in Linear
Anyone who wants bulk labeling or status comments done from a prompt

Install linear

Codex

Copy this prompt.

Install the linear skill in Codex. Run this command:

$skill-installer linear

Then check that it loaded and tell me how to use it.

2
Paste it into Codex. It shows the change and asks before running it.

Requires Codex.

Pick one skill route, then connect the Linear MCP server: the skill does nothing without it. Run the skill-installer line inside Codex. The skill folder holds 5 files including SKILL.md and bundles no scripts. The repo README says openai/skills is deprecated and points to openai/plugins.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Manage issues, projects & team workflows in Linear. Use when the user wants to read, create or updates tickets in Linear.

Sections in SKILL.md

Overview
Prerequisites
Required Workflow
Step 0: Set up Linear MCP (if not already configured)
Step 1
Step 2
Step 3
Step 4
Available Tools
Practical Workflows
Tips for Maximum Productivity
Troubleshooting

Key facts

Author: openai (repo owner of openai/skills). Not published by Linear
License: Apache License 2.0 text in the skill's LICENSE.txt
Installs on skills.sh: 10,626 (Nov 2, 2026)
GitHub stars: 28,447 for the whole openai/skills repo (Nov 2, 2026)
Last repo commit: Oct 28, 2026
What it includes: 5 files including SKILL.md: LICENSE.txt, agents/openai.yaml and two icons in assets/ (no scripts)
Needs: The Linear MCP server connected with OAuth, and access to your Linear workspace
Repo status: The openai/skills README says the repository is deprecated and points to the OpenAI Plugins repository
Works in: Codex (SKILL.md short description: "Manage Linear issues in Codex")

What it includes

If an MCP call fails, adds the Linear server and logs in with OAuth
Uses codex mcp add, enables the remote MCP client, runs codex mcp login linear, then asks you to restart Codex.
Runs code · Step 0: connect Linear MCP
Confirms scope: triage, sprint planning, doc audit or workload balance
Also confirms team, project, priority, labels, cycle and due dates as needed.
Read · Step 1: clarify the goal
Chooses a workflow and confirms issue, project and team identifiers
IDs are confirmed before any tool call.
Read · Step 2: pick the workflow
Reads first, then creates or updates, and explains bulk groupings first
Read with list, get and search. Write with issues, projects, labels and comments.
Write · Step 3: run tool calls
Reports results, gaps and blockers, and proposes next actions
Next actions can be more issues, label changes, assignments or follow-up comments.
Read · Step 4: summarize
8 tools to list, get, create and update issues, statuses and labels
list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label.
Write · Issue tools
7 tools for projects, teams and users
list_projects, get_project, create_project, update_project, list_teams, get_team, list_users.
Write · Project and team tools
6 tools for documents, docs search, comments and cycles
list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles.
Write · Docs and collaboration tools
Nine named workflows such as sprint planning, bug triage and smart labeling
Also documentation audit, workload balance, release planning, cross-project dependencies, status updates and retrospectives.
Write · Practical workflows

From the official docs

Permissions

Medium risk

Codex can create and update issues, projects and comments in your Linear workspace using your sign-in. Ask for lookups only when you do not want changes.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can create and update items in your Linear workspace
The tools it lists include create_issue, update_issue, create_project, update_project, create_comment and create_issue_label. Say in your prompt if you only want lookups. github.com
Bulk changes happen in batches
SKILL.md says to explain the grouping logic before applying a bulk change. Check that explanation before you let it continue. github.com
The Windows/WSL fix downloads a package with npx -y
For connection errors on Windows, SKILL.md shows a config that runs npx -y mcp-remote. Only use it if you need it. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode is documented. Ask for lookups only, or sign in with an account that has limited access.
Talks to	https://mcp.linear.app/mcp (Linear MCP server, per SKILL.md and agents/openai.yaml). Windows/WSL fallback: runs npx -y mcp-remote against https://mcp.linear.app/sse
Sign-in and keys	Sign-in is OAuth through codex mcp login linear. SKILL.md does not say where Codex keeps the token.
Scopes	Calls Linear MCP tools that create and update issues, projects, labels and comments Needs access to the Linear workspace, teams and projects you point it at Step 0 runs codex mcp commands and edits Codex config if the server is missing

Questions

What does the linear skill do?

It gives Codex a set routine for managing Linear issues, projects and comments. It runs through the Linear MCP server and follows read-first, then write steps.

Is this skill made by Linear?

No. It sits in OpenAI's openai/skills repo, so it is not published by Linear. It drives Linear through the Linear MCP server, which has its own page: Linear MCP server.

How do I install it in Codex?

Use the install box at the top of this page. The repo README installs curated skills with the skill-installer inside Codex. Then connect the Linear MCP server with the steps shown there, and restart Codex.

Does it work in Claude Code or ChatGPT?

This page documents Codex only. SKILL.md's setup steps are Codex commands, and the skill relies on a Linear MCP server being connected in your assistant. Elsewhere, connect Linear's server yourself first; the Linear MCP server page covers that.

Does it need an API key?

SKILL.md names no API key. It needs the Linear MCP server connected with an OAuth sign-in to your Linear workspace.

Can it change or delete my Linear data?

It can create and update issues, projects, labels and comments, since those tools are in its list. None of the tools SKILL.md names is a delete tool. For bulk changes it explains the grouping before applying them.

Is the openai/skills repo deprecated?

The README says so and points to the OpenAI Plugins repository for current examples. The linear skill is still in the repo, and this page describes it as it stands there.

Is it safe to install?

Installing adds a SKILL.md, a license, a small config file and two icons, and bundles no scripts. When used, Codex acts in your Linear workspace with your sign-in, so ask for read-only lookups if you do not want changes.

Information

updated Nov 2, 2026

Repository: openai/skills
Folder: skills/.curated/linear

openai/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

linear SKILL.md · github.com
openai/skills README · github.com
linear agents/openai.yaml · github.com