linear

Manage Linear issues, projects, teams, and documents via the GraphQL API.

1|Updated May 18, 2026
One-click install
npx skills add https://github.com/rickyananda/hermes-skills --skill linear-rickyananda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/rickyananda/hermes-skills/tree/main/productivity/linear
Command: npx skills add https://github.com/rickyananda/hermes-skills --skill linear-rickyananda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Linear teams often need to inspect, triage, and update work without switching to the web app, and this Skill lets an AI handle those product operations directly.

Core Features & Use Cases

  • Issue management: find, create, update, assign, comment on, and retitle issues.
  • Project and team coordination: list teams, workflow states, projects, labels, and assignees to support planning and execution.
  • Document access: fetch and search Linear documents by slug or ID for specs, notes, and RFCs.
  • Use case: A product manager can ask for a team’s open issues, move a ticket to the correct state, and add a follow-up comment in one workflow.

Quick Start

Ask the Linear skill to list my assigned issues for the ENG team and move ENG-42 to the team’s In Progress state.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I manage Linear issues from the command line?

You can manage Linear issues from the command line by using a Skill that leverages the Linear GraphQL API to search, create, update, assign, and comment on issues directly without the web app. It relies on curl and Python for automation.

Do I need a personal API key to automate Linear project tracking?

Yes, automating Linear project tracking requires a personal API key set in the LINEAR_API_KEY environment variable to authenticate GraphQL requests for listing teams, workflow states, and updating projects.

Can I update Linear workflow states and add comments via GraphQL?

Yes, you can update Linear workflow states and add comments via GraphQL by executing requests that move issues to specific states like In Progress and append follow-up comments in a single product operation workflow.

What is the best way to fetch Linear documents for RFCs and specs?

The best way to fetch Linear documents for RFCs and specs is to use GraphQL queries that retrieve and search documents by slug or ID, allowing direct access to specs and notes without manual web navigation.

Does the Linear Skill work with Python standard-library automation?

Yes, the Linear Skill works with Python standard-library automation by using a bundled Python helper that constructs and executes GraphQL requests via curl, streamlining day-to-day product operations.

How do I list teams and assignees for Linear issue triage?

You can list teams and assignees for Linear issue triage by querying the Linear GraphQL API to retrieve available teams, workflow states, labels, and assignees, supporting direct execution and planning from the terminal.