How do I install the Linear skill?

Run npx skillmds@latest add bentossell/linear 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 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?

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 free to use?

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

Who published Linear?

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

Linear by bentossell — Agent Skill

Name: Linear
Author: bentossell

Linear

Minimal CLI tools for Linear issue management. Use when you need to list issues, view workflow states, change issue status, or move issues between teams. Tools use Linear's GraphQL API with personal API key authentication.

bentossell f532467 7 files · 17.0 KB Updated Sep 17, 2026

File contents

Linear Tools

You have access to minimal Linear CLI tools for issue management. These are simple bash scripts that use Linear's GraphQL API.

Available Tools

All scripts are in the skill directory and are executable. They output human-readable text.

Authentication

./auth.js <your-api-key>

assignee

My user account is ben@factory.ai

List Issues

./issues.js                          # List all issues
./issues.js --team "TEAM-ID"         # Filter by team
./issues.js --assignee me            # Filter by current user
./issues.js --assignee user@email.com # Filter by assignee email
./issues.js --limit 20               # Limit results
./issues.js --id DR-20               # Fetch single issue by identifier
./issues.js DR-20                    # Fetch single issue (shorthand)

Fetches issues with their ID, identifier, title, description, status, team, and assignee. Use --id flag or pass issue identifier as first argument to fetch a single issue. Use --assignee to filter by assignee (supports "me" or email address).

List Workflow States

./states.js

Lists all workflow states (statuses) with their IDs and names, grouped by team. Use these state IDs to change issue status.

Manage Teams

./team.js                          # List all teams
./team.js <issue-id> <team-id>     # Move issue to team
./team.js OPS-1212 <team-id>       # Example: move issue to team

Lists all available teams with their IDs and keys, or moves an issue to a different team. Accepts either the short identifier (OPS-1212) or full UUID. Use without arguments to see all teams first.

Change Issue Status

./status.js <issue-id> <state-id>
./status.js BLA-123 <state-id>

Updates an issue's workflow state. Accepts either the short identifier (BLA-123) or full UUID.

---name: lineardescription: Minimal CLI tools for Linear issue management. Use when you need to list issues, view workflow states, change issue status, or move issues between teams. Tools use Linear's GraphQL API with personal API key authentication.---# Linear ToolsYou have access to minimal Linear CLI tools for issue management. These are simple bash scripts that use Linear's GraphQL API.## Available ToolsAll scripts are in the skill directory and are executable. They output human-readable text.### Authentication```bash./auth.js <your-api-key>```### assigneeMy user account is ben@factory.ai### List Issues```bash./issues.js # List all issues./issues.js --team "TEAM-ID" # Filter by team./issues.js --assignee me # Filter by current user./issues.js --assignee user@email.com # Filter by assignee email./issues.js --limit 20 # Limit results./issues.js --id DR-20 # Fetch single issue by identifier./issues.js DR-20 # Fetch single issue (shorthand)```Fetches issues with their ID, identifier, title, description, status, team, and assignee. Use --id flag or pass issue identifier as first argument to fetch a single issue. Use --assignee to filter by assignee (supports "me" or email address).### List Workflow States```bash./states.js```Lists all workflow states (statuses) with their IDs and names, grouped by team. Use these state IDs to change issue status.### Manage Teams```bash./team.js # List all teams./team.js <issue-id> <team-id> # Move issue to team./team.js OPS-1212 <team-id> # Example: move issue to team```Lists all available teams with their IDs and keys, or moves an issue to a different team. Accepts either the short identifier (OPS-1212) or full UUID. Use without arguments to see all teams first.### Change Issue Status```bash./status.js <issue-id> <state-id>./status.js BLA-123 <state-id>```Updates an issue's workflow state. Accepts either the short identifier (BLA-123) or full UUID.

Frequently asked questions