linear

Retrieve Linear issues, check sub-issues, update statuses, and add completion comments.

Updated Aug 30, 2025
One-click install
npx skills add https://github.com/cute-baobao/pm --skill linear-cute-baobao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/cute-baobao/pm/tree/main/.agents/skills/linear
Command: npx skills add https://github.com/cute-baobao/pm --skill linear-cute-baobao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linear issue management helps teams track and close work efficiently by standardizing how issues are retrieved, updated, and documented.

Core Features & Use Cases

  • Retrieve issue details from Linear, check for sub-issues, and maintain accurate work tracking.
  • Update issue status when tasks are completed and enforce mandatory completion comments.
  • PR association is required: include magic keywords in PR bodies to link to Linear issues and summarize changes.

Quick Start

Initiate a Linear workflow by retrieving an issue, updating its status, and immediately adding a completion comment to all referenced issues after the PR is created.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I automatically update Linear issue statuses when a pull request is merged?

To update Linear issue statuses automatically, this workflow retrieves the issue, checks for sub-issues, and applies status updates through defined actions when PRs reference the issue using magic keywords. It enforces mandatory completion comments to document the changes.

Can I enforce mandatory completion comments on Linear issues before closing them?

Yes, you can enforce mandatory completion comments on Linear issues. The workflow implements deterministic steps that require creating a comment on the issue whenever its status is updated, ensuring accurate work tracking and documentation.

What is the best way to link a pull request to a Linear issue for tracking?

The best way to link a pull request to a Linear issue is by including specific magic keywords in the PR body. This PR association rule triggers the workflow to retrieve issue details and list sub-issues using a parentId filter for accurate tracking.

How do I check for sub-issues in Linear to ensure accurate work tracking?

To check for sub-issues in Linear, the workflow retrieves the parent issue details and then lists issues using a parentId filter. This ensures all child tasks are accounted for before applying status updates or completion comments.

Does this Linear workflow require any specific dependencies or components to run?

No specific dependencies or components are required to run this Linear workflow. It operates as a standalone automation that directly performs get_issue, update_issue, and create_comment actions to manage your issue tracking.

Why are my Linear issue updates not reflecting when I reference them in a PR?

Linear issue updates may not reflect if PR association rules are not met. You must include the correct magic keywords in the PR body to link to the Linear issues, which then triggers the deterministic workflow to update statuses and add comments.