How do I install the Linear Tasks skill?

Run npx skillmds@latest add incidentfox/linear-tasks in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Linear Tasks safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linear Tasks?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linear Tasks free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Linear Tasks?

incidentfox (@incidentfox) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linear Tasks by incidentfox — Agent Skill

Name: Linear Tasks
Author: incidentfox

File contents

Linear Issue Tracking

Authentication

Set the LINEAR_API_KEY environment variable with a Linear API key (from Settings > API).

Priority Levels

Value	Level
0	No priority
1	Urgent
2	High
3	Medium
4	Low

Available Scripts

All scripts are in .claude/skills/linear-tasks/scripts/

create_issue.py - Create Issue

python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix bug" [--description "..."] [--priority 2]

# Examples:
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix auth timeout" --description "Users report 504 on login" --priority 2
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Update docs" --team-id TEAM_UUID
python .claude/skills/linear-tasks/scripts/create_issue.py --title "Security review" --priority 1 --labels "security,urgent"

list_issues.py - List/Search Issues

python .claude/skills/linear-tasks/scripts/list_issues.py [--state "In Progress"] [--max-results 50]

# Examples:
python .claude/skills/linear-tasks/scripts/list_issues.py
python .claude/skills/linear-tasks/scripts/list_issues.py --state "In Progress"
python .claude/skills/linear-tasks/scripts/list_issues.py --state "Todo" --max-results 20

Client Library Functions

The linear_client.py module provides a GraphQL client:

Function	Purpose
`graphql_request(query, variables)`	Execute any GraphQL query against Linear
`create_issue(title, description, ...)`	Create a new issue
`search_issues(query)`	Search issues by text
`get_issue(issue_id)`	Get issue details by identifier

Common Workflows

1. Create a Task from a Conversation

python create_issue.py --title "Update refund policy docs" \
  --description "Customer asked about refund timeline — docs are outdated" \
  --priority 3

2. Check Team Workload

python list_issues.py --state "In Progress"

3. Find Related Issues

python list_issues.py --state "Todo" --max-results 100

Quick Reference

Goal	Command
Create issue	`create_issue.py --title "Title" --priority 2`
List open issues	`list_issues.py --state "In Progress"`
List all issues	`list_issues.py --max-results 100`

---name: linear-tasksdescription: Linear issue tracking and project management. Use for creating issues, searching issues, getting issue details, and managing tasks in Linear.---# Linear Issue Tracking## AuthenticationSet the `LINEAR_API_KEY` environment variable with a Linear API key (from Settings > API).---## Priority Levels| Value | Level ||-------|-------|| 0 | No priority || 1 | Urgent || 2 | High || 3 | Medium || 4 | Low |---## Available ScriptsAll scripts are in `.claude/skills/linear-tasks/scripts/`### create_issue.py - Create Issue```bashpython .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix bug" [--description "..."] [--priority 2]# Examples:python .claude/skills/linear-tasks/scripts/create_issue.py --title "Fix auth timeout" --description "Users report 504 on login" --priority 2python .claude/skills/linear-tasks/scripts/create_issue.py --title "Update docs" --team-id TEAM_UUIDpython .claude/skills/linear-tasks/scripts/create_issue.py --title "Security review" --priority 1 --labels "security,urgent"```### list_issues.py - List/Search Issues```bashpython .claude/skills/linear-tasks/scripts/list_issues.py [--state "In Progress"] [--max-results 50]# Examples:python .claude/skills/linear-tasks/scripts/list_issues.pypython .claude/skills/linear-tasks/scripts/list_issues.py --state "In Progress"python .claude/skills/linear-tasks/scripts/list_issues.py --state "Todo" --max-results 20```---## Client Library FunctionsThe `linear_client.py` module provides a GraphQL client:| Function | Purpose ||----------|---------|| `graphql_request(query, variables)` | Execute any GraphQL query against Linear || `create_issue(title, description, ...)` | Create a new issue || `search_issues(query)` | Search issues by text || `get_issue(issue_id)` | Get issue details by identifier |---## Common Workflows### 1. Create a Task from a Conversation```bashpython create_issue.py --title "Update refund policy docs" \ --description "Customer asked about refund timeline — docs are outdated" \ --priority 3```### 2. Check Team Workload```bashpython list_issues.py --state "In Progress"```### 3. Find Related Issues```bashpython list_issues.py --state "Todo" --max-results 100```---## Quick Reference| Goal | Command ||------|---------|| Create issue | `create_issue.py --title "Title" --priority 2` || List open issues | `list_issues.py --state "In Progress"` || List all issues | `list_issues.py --max-results 100` |

Frequently asked questions

Linear Tasks