#What it does

The linear skill provides a structured workflow for managing issues, projects, and team workflows in Linear. It integrates with the Linear MCP server for natural-language project management covering issues, projects, documentation, and team collaboration.

#How to use

$linear

Use Linear context to triage or update relevant issues for this task, with clear next actions.

#Workflow

1. Set up Linear MCP -- Connect via codex mcp add linear --url https://mcp.linear.app/mcp
2. Clarify scope -- Confirm the user's goal (triage, sprint planning, documentation audit, workload balance)
3. Select workflow -- Choose from practical workflows below
4. Execute tool calls -- Read first (list/get/search), then create or update in logical batches
5. Summarize -- Report results, call out gaps or blockers, propose next actions

#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 and Team -- list_projects, get_project, create_project, update_project, list_teams, get_team, list_users
• Documentation -- list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

#Practical workflows

• Sprint Planning -- Review open issues, pick top items by priority, create a new cycle with assignments
• Bug Triage -- List critical/high-priority bugs, rank by user impact, move top items to "In Progress"
• Documentation Audit -- Search docs, open labeled issues for gaps or outdated sections
• Team Workload Balance -- Group issues by assignee, flag high load, suggest redistributions
• Release Planning -- Create a project with milestones and generate issues with estimates
• Smart Labeling -- Analyze unlabeled issues, suggest/apply labels, create missing categories
• Sprint Retrospectives -- Generate a report for the last cycle, note completed vs pushed work

#Dependencies

• Linear MCP server (https://mcp.linear.app/mcp)

This skill is from the OpenAI Skills Catalog.