OpenParable
Skip to content
← Back to skills

Jira Read Ticket

Productivity
jira-read-ticket

Jira Read Ticket is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use whenever a user mentions or references a Jira ticket and you want to pull out description, comments, or more.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/jira-read-ticket/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/jira-read-ticket, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Jira data access instructions

Retrieve Jira issue data from Atlassian Cloud and return only the requested fields in JSON format.

Inputs

  • Jira issue key or ticket URL
  • Environment variables: ATLASSIAN_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN

Workflow

1) Verify environment variables

  • Ensure all required variables are set. Never output or log token values.
  • If missing, ask the user to set them before calling the API.

Variables: ATLASSIAN_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN

2) Identify the issue key

  • If the user provides a URL, parse the key (example: https://.../browse/ABC-123 -> ABC-123).
  • If the key is missing, ask the user for it.

3) Fetch data

Use these scripts before alternatives:

  • scripts/fetch_comments.py: Gets all ticket comments as JSON.
  • scripts/fetch_assigned_tickets.py: Gets assigned tickets (JSON array).
  • scripts/fetch_description.py: Gets description and details for one ticket (JSON).

Alternatively, use Jira REST API v3 with basic authentication, curl, and jq. Example for assigned tickets with JQL:

curl -s \
  -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  "$ATLASSIAN_URL/rest/api/3/search/jql" \
  --data '{
    "jql": "assignee = currentUser()",
    "fields": ["key", "summary", "status", "issuetype", "project"],
    "maxResults": 100
  }'
  • Use the fields parameter to limit payload when only specific fields are needed.

4) Extract results

  • Python scripts return JSON.
  • When using curl, use jq to extract fields of interest.

Notes

  • Jira may return rich text (Atlassian Document Format). Prefer renderedFields, fallback to fields.
  • Use /rest/api/3/search/jql for JQL POST requests. /rest/api/3/search is deprecated.
  • Retry API requests with increased permissions if network restrictions occur.
  • Never log or output secrets—reference environment variable names only.
  • Read-only operation: do not alter ticket data unless explicitly authorized by the user.