From jira-skills
Transition a Jira issue to a new workflow state. Use when a user asks to move, update, or transition a Jira work item.
How this skill is triggered — by the user, by Claude, or both
Slash command
/jira-skills:jira-update-stateThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Transition a Jira work item to a new workflow state. The skill uses the Jira
Transition a Jira work item to a new workflow state. The skill uses the Jira
REST API when JIRA_API_TOKEN is available and falls back to the Atlassian CLI
(acli) otherwise.
In Progress, Done, or another
workflow state$ARGUMENTS contains the Jira issue key followed by the target state, for
example PROJECT-123 In Progress.
Treat the first token as the issue key and the remaining text as the desired state name.
Check whether JIRA_API_TOKEN is set.
Require the following environment variables and fail with a clear message if any are missing:
JIRA_BASE_URLJIRA_EMAILJIRA_API_TOKENFetch the available transitions:
GET {JIRA_BASE_URL}/rest/api/3/issue/{issueKey}/transitions
Use HTTP Basic auth with {JIRA_EMAIL}:{JIRA_API_TOKEN}.
Find the transition whose name matches the requested state case-insensitively.
If no match exists, list the available transition names and stop.
Apply the matching transition:
POST {JIRA_BASE_URL}/rest/api/3/issue/{issueKey}/transitions
Content-Type: application/json
Body: {"transition": {"id": "<transitionId>"}}
Confirm success with Successfully transitioned {issueKey} to "{state}".
If the API returns an error, report the HTTP status and response message.
Verify that acli is installed with acli --version.
If it is missing, stop and print:
acli is not installed. Install it with: npm install -g @atlassian/acli
Then authenticate with: acli configure
Run:
acli jira workitem transition --id {issueKey} --state "{state}"
Display the command output on success. If the command fails, show the error and suggest checking valid transitions in Jira when the state name is invalid.
Return a short success confirmation or a clear failure message. When the state cannot be applied, include the available transitions or the CLI error output.
/jira-update-state PROJECT-123 In Progress
move PROJECT-456 to Done
transition MYTEAM-9 to Ready for Test
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub rogerbriggen/ai_skills --plugin jira-skills