skills.rest
gonzoblasco
gonzoblascoCOMMUNITY
Explore all skills by this author →
𝕏@gonzoblascoGitHub

linear-expert

Manage Linear issues, projects, and teams via MCP tools, CLI, or GraphQL API.

1|Updated Jul 20, 2026
Search Tags:#project management#api#cli#graphql#mcp#issue tracking#linear
One-click install
npx skills add https://github.com/gonzoblasco/ai-developer-stack --skill linear-expert-gonzoblasco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-expert
Source: https://github.com/gonzoblasco/ai-developer-stack/tree/main/tools-automation/linear-expert
Command: npx skills add https://github.com/gonzoblasco/ai-developer-stack --skill linear-expert-gonzoblasco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Linear issues, projects, and teams requires switching between tools and remembering API details. This Skill provides a unified workflow for interacting with Linear through whichever method is available in your environment, while enforcing safe credential handling. ## Core Features & Use Cases - Multi-Method Access: Interact with Linear through MCP tools, the Linear CLI, or direct GraphQL API calls with curl, depending on what is configured. - Secure Credential Handling: Enforces safe practices for the LINEAR_API_KEY, preventing accidental exposure in terminal output or committed files. - Project Planning Workflow: Guides issue-to-project-to-initiative organization with domain-based labeling conventions (type, domain, scope labels). - Use Case: You need to create a bug issue, link it to a project, and update its status to Done. The Skill checks for an MCP server first, falls back to the CLI, and finally uses a GraphQL mutation if neither is available. ## Quick Start Ask the agent to create a Linear issue titled "Fix login redirect bug" in your team and assign it the bug and frontend labels.

Frequently Asked Questions about linear-expert

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?▼

Use the Linear CLI with 'linear issues create --title "Title" --description "Description"'. If the CLI is unavailable, send a GraphQL issueCreate mutation via curl to https://api.linear.app/graphql with your LINEAR_API_KEY in the Authorization header.

How do I query the Linear GraphQL API with curl?▼

Send a POST request to https://api.linear.app/graphql with Content-Type application/json and your LINEAR_API_KEY as the Authorization header. Include your GraphQL query or mutation in the JSON body, such as a viewer query or issueCreate mutation.

What should I use if no Linear MCP server or CLI is available?▼

Use direct GraphQL API calls with curl as the fallback method. This gives maximum control over queries and mutations and only requires the LINEAR_API_KEY environment variable to be set.

How do I safely store my Linear API key?▼

Store LINEAR_API_KEY in your shell profile (~/.zshrc or ~/.bashrc) or a local uncommitted .env file. Never print the full key in terminal output or commit it to git; show only a short prefix when debugging.

What are the limitations of this Linear management approach?▼

The Skill only covers Linear issue, project, and team management, not other platforms. It also depends on which tools are available in your environment, so some methods may be unavailable without an MCP server or CLI installation.

Related Skills

Explore More Product & Management Skills→
bowiemaxbowiemax

wwas

Generate product backlog items in the Why-What-Acceptance format.

Community
Basic
ttphatsttphats

project-flow-ops

Triages GitHub issues and pull requests and coordinates execution tracking with Linear.

Community
Intermediate
arch-teamarch-team
73

pace-sync

Synchronize devpace development state with GitHub, Linear, and Jira.

Community
Advanced
librefanglibrefang
10

linear-tools

Automate Linear issue, cycle, and project planning via the GraphQL API.

Official
Advanced