jira

name	jira
description	Search Jira issues with JQL or free text, and read Jira issue details with comments using the external jira-cli (`jira`) command. Use when the user asks to find Jira tickets, inspect issue details, review comments, or run Jira queries.

Jira

Search Jira issues and read issue details with jira.

jira issue list --jql 'text ~ "workflow runner failure"' --paginate 0:10 --raw

Search Issues

Search with free text:

jira issue list "build failure" --paginate 0:10 --raw

Search with explicit JQL:

jira issue list --jql "project = PROJ AND statusCategory != Done ORDER BY updated DESC" --paginate 0:10 --raw

Common options:

• --jql: Raw JQL query
• positional text: Free-text query
• --paginate 0:10: Offset/limit style pagination
• --raw: JSON output for deterministic parsing

Read Issue

Read one issue with comments:

jira issue view PROJ-1234 --comments 20 --raw

Read plain text output (non-JSON):

jira issue view PROJ-1234 --comments 5 --plain

Guardrails

Prefer read-only commands in this skill:

• jira issue list ...
• jira issue view ...

Avoid mutating commands unless the user explicitly requests edits (for example jira issue create, jira issue edit, jira issue delete, jira issue move, jira issue assign, jira issue comment add).

Use --raw whenever machine-readable output is needed.