Agent skill · magnus919
jira-cli
Interact with Atlassian Jira from the terminal: search issues, view
What it needs
About 3k tokens when loaded.
What this skill does
jira-cli — Jira Issue Tracker from the Terminal Interact with Atlassian Jira Cloud via the REST API v3. Search issues, view details, create issues, add comments, list projects, and transition status. Setup 1. Generate an API token at id.atlassian.com/manage/api-tokens 2. Set environment variables: --help and --dry-run work without credentials. Essential Commands me — Current user profile list — Search issues The --jql flag accepts any valid JQL. The --project flag is a shortcut for project=KEY. view — Issue details Shows: summary, type, status, priority, assignee, reporter, timestamps, and description (plain text extracted from Atlassian Document Format). projects — List projects create — Create an issue comment — Add a comment transition — Change issue status The CLI looks up available transitions for the issue and matches by name or ID. If the transition doesn't exist, it shows available options. Global Flags All flags work in any position: Known Gotchas Authentication uses HTTP Basic Auth with email + API token. This is the email address tied to your Atlassian account, not a username. Atlassian Document Format (ADF) — Issue descriptions and comments use ADF (JSON structure), not plain text or markdown. The CLI extracts plain text from ADF, but creating issues with rich formatting requires ADF JSON via --description. Transitions are workflow-specific — Available transitions depend on the issue's current status and the project's workflow. The CLI lists available options when an invalid transition is requested. Rate limits — Jira Cloud has rate limits. The API returns 429 if exceeded. The CLI does not auto-retry. Project keys are case-sensitive in some contexts, but the Jira API generally accepts uppercase or lowercase. References scripts/jira-cli — The CLI binary. Built following the cli-builder patterns: non-interactive, --json, --dry-run, --quiet, --verbose, dual-output via emit(), lazy auth, structured logging. Jira REST API v3 docs — Official API reference. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/jira-cli