Do I need to be authenticated?

Yes. The skill relies on the identity step to assume the agent's identity, and workspace credentials may be required via -w to access the correct workspace.

How do I open the issue in a browser or app?

Use --web to open in a web browser or --app to open in Linear.app.

How do I get machine-readable output?

Use -j/--json to output the issue data as JSON for automation and scripting.

linear-issue-view

Scanned

npx machina-cli add skill bryanp/agent-skills/view --openclaw

Files (1)

SKILL.md

831 B

Use the linear issue view command to view an issue.

Rule: Identity

First use the identity skill to assume the identity of the agent.

Usage

Usage:   linear issue view [issueId]
Version: 1.10.0

Description:

  View issue details (default) or open in browser/app

Options:

  -h, --help               - Show this help.
  -w, --workspace  <slug>  - Target workspace (uses credentials)
  -w, --web                - Open in web browser
  -a, --app                - Open in Linear.app
  --no-comments            - Exclude comments from the output
  --no-pager               - Disable automatic paging for long output
  -j, --json               - Output issue data as JSON
  --no-download            - Keep remote URLs instead of downloading files

Source

git clone https://github.com/bryanp/agent-skills/blob/main/code/linear/issue/view/SKILL.mdView on GitHub

Overview

This skill uses the linear issue view command to fetch and display details for a Linear issue by ID. It supports viewing in-terminal, or opening in web browser or Linear.app, with options to exclude comments, output JSON, or disable paging.

How This Skill Works

After the identity step to assume the agent, the skill runs the CLI command linear issue view [issueId] with optional flags (such as -w for workspace, --web to open in a browser, --app to open in Linear.app, --no-comments, --no-pager, -j/--json). The workspace flag leverages credentials to target the correct workspace.

When to Use It

To fetch and display details for a specific Linear issue by its ID in your terminal.
To open the issue directly in a web browser using the --web flag.
To open the issue in Linear.app with the --app flag.
For automation and scripting, output JSON with -j/--json for easy parsing.
To reduce noise or long outputs, use --no-comments or --no-pager as needed.

Quick Start

Step 1: Use the identity skill to assume the agent's identity.
Step 2: Run linear issue view ISSUE-123 to view the issue details.
Step 3: Add flags as needed (e.g., --web, --json, --no-comments) to fit your workflow.

Best Practices

Always perform identity first using the identity skill to assume the agent's identity.
Use --web or --app only when you need to view the issue outside the terminal.
Use -j/--json for machine-readable output in automation pipelines.
Use --no-comments to focus on the issue summary when comments are not needed.
Specify -w <slug> to ensure you target the correct workspace with credentials.

Example Use Cases

linear issue view ISSUE-123
linear issue view ISSUE-123 --web
linear issue view ISSUE-123 --json
linear issue view ISSUE-123 --app
linear issue view ISSUE-123 --no-comments --no-pager

Frequently Asked Questions

Add this skill to your agents