jira
Installation
SKILL.md
Jira Work Item Management
Uses Atlassian CLI (acli) to view, search, filter, create, and update work items in Jira projects.
Prerequisites
Check that both dependencies are available before running any commands. Do this once at the start of the session, not before every command.
- acli — run
acli --version. If missing, read references/prerequisites.md for install instructions. - mdadf — run
mdadf --version. If missing, read references/prerequisites.md for install instructions.
If either tool is missing and cannot be installed (e.g. no network access), tell the user exactly what commands to run and stop.
Operating Constraints
- READ-ONLY for Projects: Never modify Jira projects themselves. Only create, update, or delete work items within projects.
- Mutation Intent: For create, edit, transition, assign, comment, or delete operations, only mutate Jira when the user explicitly asks for that change. If the request is ambiguous, clarify before mutating.
- Key-First Targeting: If the user provides a work item key such as
MYPROJECT-1455, use it directly rather than writing JQL. The exact CLI syntax varies per subcommand (viewuses a positional argument;edit,transition,assign, andcommentuse a--keyflag) — see references/commands.md. - JQL: Use
--jqlfor selecting, searching, or filtering work items when applicable.