jira-ticket

Jira Ticket — Create, Comment, or Update Description

Three modes, one content engine. The presence of a Jira issue key in the arguments (and whether description is also passed) determines the mode.

Validate env vars

Before parsing arguments or doing any Jira work, run this exact command to check the environment:

echo "JIRA_URL=${JIRA_URL:-NOT_SET}" && \
echo "JIRA_USERNAME=${JIRA_USERNAME:-NOT_SET}" && \
echo "JIRA_API_TOKEN=${JIRA_API_TOKEN:+SET}" && \
echo "JIRA_PERSONAL_TOKEN=${JIRA_PERSONAL_TOKEN:+SET}" && \
echo "JIRA_PROJECT_KEY=${JIRA_PROJECT_KEY:-NOT_SET}" && \
echo "JIRA_BOARD_ID=${JIRA_BOARD_ID:-NOT_SET}"

Required for any run:

• JIRA_URL is set
• Auth is set: either JIRA_USERNAME + JIRA_API_TOKEN (Cloud) or JIRA_PERSONAL_TOKEN (Server / Data Center)
• JIRA_PROJECT_KEY is set
• The mcp__mcp-atlassian__jira_create_issue tool is visible in your tool list (i.e. the mcp-atlassian server is registered)

Required only if the user passed a sprint argument (current, sprint, next):

• JIRA_BOARD_ID is set

If anything required is missing, tell the user one line — "Jira isn't fully configured; running /jira-setup to fix what's missing." — then invoke the jira-setup skill via the Skill tool. After setup completes, re-run this validation. Only proceed once everything required is green.

If the jira-setup skill isn't available in this session for any reason, fall back to instructing the user: "Run /jira-setup and then re-run /jira-ticket."

Parsing Arguments

/jira-ticket [args] — parse the comma-separated arguments to determine the mode.

The Jira issue key pattern in this skill is ${JIRA_PROJECT_KEY}-\d+ (e.g., if JIRA_PROJECT_KEY=PROJ, then PROJ-1234).

Mode Detection

• If any standalone argument exactly matches the issue key pattern:
  • If description is also passed as an argument → enter Update Description Mode
  • Otherwise → enter Comment Mode The entire trimmed argument must be the issue key — ignore keys that appear as part of other arguments (e.g., epic PROJ-1234 is an epic linking argument, not a comment target).
• Otherwise, enter Create Mode