Agent-Skills.md

Agent Skills: Linear

Linear issue management (search, create, update, close, comment) with arbitrary GraphQL queries.

UncategorizedID: ianchenx/ian-skills/linear

Repository

ianchenx/ian-skills
ianchenx
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ianchenx/ian-skills/tree/HEAD/skills/linear

Skill Files

Browse the full folder contents for linear.

Download Skill

Loading file tree…

skills/linear/SKILL.md

Skill Metadata

Name
linear
Description
Linear issue management (search, create, update, close, comment) with arbitrary GraphQL queries.

Linear

Direct Linear GraphQL API access via Bun CLI. Zero external dependencies.

Two script variants:

| Script | Size | Use Case | |--------|------|----------| | scripts/linear.ts | ~120 lines | Standard: setup + api, agent constructs queries using api.md | | scripts/linear-issue.ts | ~570 lines | Issue-specific: wraps search/create/update/list/comment as named commands |

Setup

Check if config.json exists in this directory:

  • Exists → use directly
  • Missing → ensure LINEAR_API_KEY env var is set (Linear Settings → API → Personal API Keys), then run:
bun <skill-dir>/scripts/linear.ts setup
# or (full version)
bun <skill-dir>/scripts/linear-issue.ts setup

Config structure:

{ "apiKey": "$LINEAR_API_KEY", "teamKey": "YOUR_TEAM_KEY" }
  • apiKey: API key or env var reference ($LINEAR_API_KEY)
  • teamKey: Linear team key (e.g. WOR)

Issue Commands (linear-issue.ts)

| Command | Purpose | |---|---| | setup | Interactive config.json initialization | | search <query> | Search issues by keyword | | list [--state <name>] [--project <slug>] | List issues | | create --title "..." [--body "..." \| --body-file path] [--template feat] | Create issue | | update <id> [--parent <id>] [--state <name>] | Update issue | | comment <id> [--body "..." \| --body-file path] | Add comment | | teams / templates / states | Query workspace metadata | | api '<graphql>' [--vars '<json>'] | Arbitrary GraphQL query |

Standard Commands (linear.ts)

| Command | Purpose | |---|---| | setup | Initialize config.json | | api '<graphql>' [--vars '<json>'] | Arbitrary GraphQL query |

Use --body-file for multi-line body (write to temp file) to avoid shell escaping issues.

See references/api.md for query examples and detailed usage.