skilld
All skills
openai avatar

/linear

@ea36903 official
by openaiopenai/skills28k stars
1,891

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/openai/skills/linear

This session only. Nothing lands on disk.

SKILL.md

≈32 tokens always: the name and description. ≈1.2k when used: this file. ≈115 more on demand in 1 file.

Linear

Overview

This skill provides a structured workflow for managing issues, projects & team workflows in Linear. It ensures consistent integration with the Linear MCP server, which offers natural-language project management for issues, projects, documentation, and team collaboration.

Prerequisites

  • Linear MCP server must be connected and accessible via OAuth
  • Confirm access to the relevant Linear workspace, teams, and projects

Required Workflow

Follow these steps in order. Do not skip steps.

Step 0: Set up Linear MCP (if not already configured)

If any MCP call fails because Linear MCP is not connected, pause and set it up:

  1. Add the Linear MCP:
    • codex mcp add linear --url https://mcp.linear.app/mcp
  2. Enable remote MCP client:
    • Set [features] rmcp_client = true in config.toml or run codex --enable rmcp_client
  3. Log in with OAuth:
    • codex mcp login linear

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

Windows/WSL note: If you see connection errors on Windows, try configuring the Linear MCP to run via WSL:

{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}

Step 1

Clarify the user's goal and scope (e.g., issue triage, sprint planning, documentation audit, workload balance). Confirm team/project, priority, labels, cycle, and due dates as needed.

Step 2

Select the appropriate workflow (see Practical Workflows below) and identify the Linear MCP tools you will need. Confirm required identifiers (issue ID, project ID, team key) before calling tools.

Step 3

Execute Linear MCP tool calls in logical batches:

  • Read first (list/get/search) to build context.
  • Create or update next (issues, projects, labels, comments) with all required fields.
  • For bulk operations, explain the grouping logic before applying changes.

Step 4

Summarize results, call out remaining gaps or blockers, and propose next actions (additional issues, label changes, assignments, or follow-up comments).

Available Tools

Issue Management: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Project & Team: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

Documentation & Collaboration: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

Practical Workflows

  • Sprint Planning: Review open issues for a target team, pick top items by priority, and create a new cycle (e.g., "Q1 Performance Sprint") with assignments.
  • Bug Triage: List critical/high-priority bugs, rank by user impact, and move the top items to "In Progress."
  • Documentation Audit: Search documentation (e.g., API auth), then open labeled "documentation" issues for gaps or outdated sections with detailed fixes.
  • Team Workload Balance: Group active issues by assignee, flag anyone with high load, and suggest or apply redistributions.
  • Release Planning: Create a project (e.g., "v2.0 Release") with milestones (feature freeze, beta, docs, launch) and generate issues with estimates.
  • Cross-Project Dependencies: Find all "blocked" issues, identify blockers, and create linked issues if missing.
  • Automated Status Updates: Find your issues with stale updates and add status comments based on current state/blockers.
  • Smart Labeling: Analyze unlabeled issues, suggest/apply labels, and create missing label categories.
  • Sprint Retrospectives: Generate a report for the last completed cycle, note completed vs. pushed work, and open discussion issues for patterns.

Tips for Maximum Productivity

  • Batch operations for related changes; consider smart templates for recurring issue structures.
  • Use natural queries when possible ("Show me what John is working on this week").
  • Leverage context: reference prior issues in new requests.
  • Break large updates into smaller batches to avoid rate limits; cache or reuse filters when listing frequently.

Troubleshooting

  • Authentication: Clear browser cookies, re-run OAuth, verify workspace permissions, ensure API access is enabled.
  • Tool Calling Errors: Confirm the model supports multiple tool calls, provide all required fields, and split complex requests.
  • Missing Data: Refresh token, verify workspace access, check for archived projects, and confirm correct team selection.
  • Performance: Remember Linear API rate limits; batch bulk operations, use specific filters, or cache frequent queries.

Source: SKILL.md on GitHub

Third-party checks

3 warnings17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    This skill is designed to integrate with Linear and includes standard configuration steps for Model Context Protocol (MCP) servers. It includes some security considerations regarding the ingestion of external data and the execution of setup commands, which are typical for this type of integration. See the detailed analysis for context.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    3/3 files flagged

  • ZeroLeaks5mo

    1 finding · Score: 69/100

Provenance

Signed by skilld at ea36903. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 8 months ago

Capability

metadata
{
  "short-description": "Manage Linear issues in Codex"
}

Topics

  • MCP
  • linear
  • issue-tracking
  • project-management
  • workflow-automation
  • team-collaboration
  • sprint-planning
  • bug-triage

README badge

README badge for openai/skills/linear

What it does

Manages Linear issues, projects, and team workflows via the Linear MCP server. Use this skill for sprint planning, bug triage, documentation audits, workload balancing, and cross-project dependency tracking without leaving your agent context.

Generated from the current SKILL.md.

Frequently asked

Does this skill require Linear MCP to be set up first?
Yes. The Linear MCP server must be connected and accessible via OAuth. If not already configured, the skill includes setup steps to add the MCP, enable the remote client, and log in.
What Linear operations can this skill perform?
The skill can list, get, create, and update issues; manage projects, teams, and cycles; search documentation; and create comments. It does not handle operations outside the Linear MCP tool set.
Can I use this skill to automate bulk issue updates?
Yes. The skill supports bulk operations in logical batches, but recommends splitting complex requests into smaller batches to avoid Linear API rate limits.
What should I do if Linear MCP authentication fails?
Clear browser cookies, re-run the OAuth login with `codex mcp login linear`, verify workspace permissions, and ensure API access is enabled. On Windows/WSL, try configuring the MCP to run via WSL as documented in the skill.

Generated from the current SKILL.md. These answers refresh after source changes.