AgentSkillsCN

linear-issues-read

通过CLI列出和获取Linear问题（只读操作）

SKILL.md
--- frontmatter
name: linear-issues-read
description: List and get Linear issues via CLI (read-only operations)
version: 1.0.0
license: MIT
compatibility: opencode

Overview

CLI tools for reading Linear issues. Requires LINEAR_API_KEY set in <git-root>/.env or exported in the environment.

Prerequisites

  • •bun runtime installed
  • •LINEAR_API_KEY set in <git-root>/.env or environment

Commands

List Issues

bash
bun .opencode/skill/linear-issues-read/list-issues.js [options]

Options:

  • •--team <name> - Filter by team (e.g., Engineering, Infrastructure, Product)
  • •--project <name> - Filter by project name
  • •--assignee <name> - Filter by assignee name
  • •--status <status> - Filter by status (e.g., "In Progress", "Todo", "Done")
  • •--limit <n> - Max results (default: 25)
  • •--json - Output as JSON

Examples:

bash
bun .opencode/skill/linear-issues-read/list-issues.js --team Engineering --limit 10
bun .opencode/skill/linear-issues-read/list-issues.js --assignee "George Washington" --status "In Progress"
bun .opencode/skill/linear-issues-read/list-issues.js --project "Mount Vernon" --json

Get Issue

bash
bun .opencode/skill/linear-issues-read/get-issue.js <issue-id> [options]

Arguments:

  • •issue-id - Issue identifier (e.g., ENG-123) or UUID

Options:

  • •--json - Output as JSON

Examples:

bash
bun .opencode/skill/linear-issues-read/get-issue.js ENG-123
bun .opencode/skill/linear-issues-read/get-issue.js ENG-123 --json

Output Behavior

  • •Command output is displayed directly to the user in the terminal
  • •Do not re-summarize or reformat table output - the user can already see it
  • •Only provide additional commentary if the user explicitly requests analysis, filtering, or summarization
  • •When using --json output with tools like jq, the processed results are already visible to the user

Notes

  • •Team, user, and label names are resolved automatically (case-insensitive)