skills.rest
erwinv2k-TKG
erwinv2k-TKGCOMMUNITY
Explore all skills by this author →
GitHub

linear-integration

Create, search, and manage Linear issues and projects via GraphQL scripts.

Updated Mar 26, 2026
Search Tags:#automation#project management#graphql#issue tracking#linear#ticketing#create issue
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill linear-integration-erwinv2k-tkg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-integration
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/sre-agent/.claude/skills/project-linear
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill linear-integration-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve? Managing Linear issues and projects manually through the web UI interrupts engineering workflows, especially during incident response when tickets must be created or queried quickly from the command line. ## Core Features & Use Cases - Issue Management: Create new issues with title, description, priority (0-4), assignee, labels, and team assignment, or fetch full details of any issue by identifier like TEAM-123. - Issue Search & Filtering: List issues filtered by team ID and workflow state (e.g., "In Progress") with configurable result limits. - Project Creation: Create Linear projects with name, description, team, and lead assignments. - Use Case: During an incident investigation, an SRE agent detects a recurring auth bug and immediately files a high-priority Linear issue assigned to the right team without leaving the terminal. ## Quick Start Ask the agent to create a Linear issue titled "Fix auth bug" with high priority and assign it to the backend team.

Frequently Asked Questions about linear-integration

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

Run the create_issue.py script with a required --title argument and optional flags for description, team ID, priority (0-4), assignee ID, and comma-separated label IDs. It returns the issue identifier and URL.

How do I list Linear issues filtered by state or team?▼

Use list_issues.py with optional --team-id and --state flags, such as --state "In Progress", plus --max-results to cap output. Add --json for machine-readable output.

How does Linear API authentication work in these scripts?▼

Authentication is handled by the shared linear_client.py module, which reads LINEAR_API_KEY, a sandbox JWT, or tenant/team headers from environment variables. A proxy layer can inject credentials automatically via LINEAR_BASE_URL.

What priority values does the Linear API accept?▼

Linear accepts integer priorities from 0 to 4: 0 for no priority, 1 for urgent, 2 for high, 3 for medium, and 4 for low. Pass the value with the --priority flag when creating an issue.

Why do the Linear scripts fail with GraphQL errors?▼

Failures typically come from missing or invalid credentials, an unreachable API endpoint, or invalid input IDs such as a nonexistent team or assignee. The client raises an exception listing the GraphQL errors returned by the API.

Related Skills

Explore More Product & Management Skills→
luanluan
4

fix

Convert unstructured user feedback into a structured bead issue.

Community
Intermediate
arch-teamarch-team
73

pace-feedback

Collect user feedback, classify production incidents, and generate postmortems.

Community
Advanced
cnoe-iocnoe-io
392

incident-investigation

Correlate PagerDuty incidents with Jira tickets and ArgoCD deployments into a timeline.

Official
Intermediate
unblockedunblocked
11

unblocked-context-search-issues

Search issue trackers like Jira, Linear, Asana, and GitHub Issues for known work.

Official
Intermediate