skills.rest
MLT-OSS
MLT-OSSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

linear

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

14|5|Updated Apr 9, 2026
Search Tags:#project management#api#graphql#issue tracking#linear#triage#curl
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill linear-mlt-oss
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill linear-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Linear issues normally requires switching to the Linear web UI or setting up an MCP server with OAuth. This Skill lets you create, update, search, and organize Linear issues, projects, and teams directly from the terminal using plain curl calls against the Linear GraphQL API, with only a personal API key. ## Core Features & Use Cases - Issue Operations: Create, update, assign, prioritize, label, comment on, and complete issues using GraphQL mutations with support for both UUIDs and short identifiers like ENG-123. - Search & Filtering: Query issues by text search, workflow state type, team, or assignee, with Relay-style cursor pagination for large result sets. - Project & Team Management: List teams, workflow states, members, labels, and projects, and create new projects linked to teams. - Use Case: Triage a bug report by searching for existing duplicates, creating a new issue in the ENG team with High priority, assigning it to a teammate, and moving it to In Progress — all without leaving your agent session. ## Quick Start Set the LINEAR_API_KEY environment variable, then ask the agent to list your assigned Linear issues or create a new issue in a specific team.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I create a Linear issue from the command line?▼

Send a POST request to https://api.linear.app/graphql with the issueCreate mutation, providing teamId, title, description, and priority in the input variables. Authenticate with your personal API key in the Authorization header without a Bearer prefix.

How do I change a Linear issue status via the API?▼

First query the team's workflowStates to get the target state's UUID, then call the issueUpdate mutation with the issue identifier and stateId. Linear states have six types: triage, backlog, unstarted, started, completed, and canceled.

Does the Linear API require OAuth for authentication?▼

No, personal API keys work without OAuth. Generate a key in Linear Settings under API, set it as the LINEAR_API_KEY environment variable, and pass it directly in the Authorization header with no Bearer prefix.

Can I search Linear issues by keyword or filter by assignee?▼

Yes, use the issueSearch query for full-text search, or the issues query with filter objects supporting comparators like eq, in, and contains. You can filter by team key, assignee email, state type, and combine conditions with or clauses.

What are the Linear API rate limits?▼

Linear allows 5,000 requests per hour and 3,000,000 complexity points per hour per API key. Use the first parameter to limit result sizes and monitor the X-RateLimit-Requests-Remaining response header to avoid throttling.

Related Skills

Explore More Product & Management Skills→
Devin-AXISDevin-AXIS
5.3k

linear-triage

Triages Linear issues with duplicate checks, scoped searches, and evidence-backed priority recommendations.

Community
Intermediate
mintuzmintuz
21

status-updates

Draft structured status updates with tone guidance and evidence links.

Community
Basic
sori883sori883

github-workflow

Manage GitHub repositories, branches, commits, pull requests, and issues with Linear integration.

Community
Advanced
vercel-labsvercel-labs
1.5k

linear

Emulate the Linear GraphQL API locally for testing integrations.

Official
Intermediate