jira-cli_skill

Overview

This skill provides a command-line interface to interact with Atlassian Jira for creating, viewing, editing, and transitioning issues. It streamlines sprint and epic management, work logging, assignments, and common Jira workflows directly from your terminal. Use it to automate routine project tasks and integrate Jira actions into scripts and CI flows.

How this skill works

The skill wraps the jira-cli tool to execute Jira REST actions via short, composable commands. It supports listing and querying issues with JQL, interactive or non-interactive creation, editing fields, transitions, comments, worklogs, and sprint/epic operations. Output formats include plain text, JSON, and CSV for easy scripting and integration.

When to use it

• Create, update, or search Jira issues without opening the web UI
• Transition issues through workflow states (e.g., To Do → In Progress → Done)
• Manage sprints, epics, boards, and releases from the terminal
• Assign issues, add comments, or log work time quickly
• Integrate Jira operations into scripts, CI/CD pipelines, or local automation

Best practices

• Run jira init and set JIRA_API_TOKEN before using the CLI
• Prefer --plain, --raw, or --csv for script-friendly output and automation
• Use raw JQL (--jql) for complex queries and repeatable filters
• Combine commands for common workflows (assign → move → worklog) to reduce manual steps
• Test commands in a sandbox or non-production project when scripting destructive actions like delete

Example use cases

• Create a bug and assign it to yourself in a single command for quick triage
• List all high-priority issues assigned to you in the current sprint for daily standups
• Add multiple issues to an epic or sprint from a scripted list during planning
• Log time and close an issue after completing work from your terminal
• Export issue lists as CSV or JSON for reporting or integration with other tools