helpers/skills/jira-workitem-view/SKILL.md
Retrieve and display full details of a Jira ticket. Fetches all fields and formats them for conversation context. Use when user needs ticket information or wants to examine a ticket.
npx skillsauth add opendatahub-io/ai-helpers jira-workitem-viewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Retrieve and display comprehensive details of a Jira ticket using the acli CLI.
acli must be installed and authenticated (acli jira auth)Before proceeding, verify that acli is installed and authenticated by invoking the acli-setup-check skill:
/acli-setup-check
If the setup check fails, stop execution and guide the user to fix the issue.
[A-Z]+-\d+Execute the command to retrieve all ticket fields:
acli jira workitem view "$TICKET_KEY" --fields '*all' --json
This returns a comprehensive JSON object containing all ticket fields, custom fields, and metadata.
### Step 4: Parse and Format Output
Parse the JSON output and extract the following fields for display:
#### Core Fields
- **Key**: Issue key (e.g., AIPCC-1234)
- **Summary**: Issue title
- **Type**: Issue type (Bug, Story, Epic, Feature, etc.)
- **Status**: Current status (To Do, In Progress, Done, etc.)
- **Priority**: Priority level
- **Project**: Project key and name
#### People
- **Assignee**: Current assignee (or "Unassigned")
- **Reporter**: Person who created the ticket
- **Creator**: Original creator (if different from reporter)
#### Dates
- **Created**: Creation timestamp
- **Updated**: Last update timestamp
- **Due Date**: Due date (if set)
- **Resolution Date**: When the ticket was resolved (if resolved)
#### Content
- **Description**: Convert from Atlassian Document Format (ADF) to plain text if needed. Display the first 500 characters with option to show full text.
- **Labels**: List of labels
- **Components**: List of components
- **Fix Version**: Target version (if set)
#### AIPCC Custom Fields (if applicable)
- **Status Summary** (customfield_10814): Leadership status update
- **Color Status** (customfield_10712): Red/Yellow/Green health indicator
#### Relationships
- **Parent**: Parent epic or feature (if set)
- **Child Issues**: Count and list of child issues
- **Links**: Related tickets (blocks, is blocked by, relates to, etc.)
- **Subtasks**: List of subtasks
#### Recent Activity
- **Last 3-5 Comments**: Show the most recent comments with author and timestamp
### Step 5: Display Results
Present the parsed information in a structured, human-readable format:
=== AIPCC-1234: Fix duplicate CI pipeline runs ===
Type: Bug Status: In Progress → Done Priority: Medium Assignee: code-samurai Reporter: super-picky-reviewer
Created: 2024-03-15 Updated: 2024-03-20 Due Date: 2024-03-25
Components: Wheel Package Index Labels: ci, automation, bug-fix
Description: [First 500 chars of description...] (use --full to show complete description)
Status Summary (2024-03-20): Work progressing normally. CI fix merged and tested in staging. Ready for production rollout next sprint. Color Status: Green
Links:
Recent Comments (3): [2024-03-20] code-samurai: Fix verified in staging, ready to merge [2024-03-19] super-picky-reviewer: LGTM, approved for merge [2024-03-18] code-samurai: Initial fix implemented, testing locally
View in Jira: https://redhat.atlassian.net/browse/AIPCC-1234
### Step 6: Offer Additional Options
After displaying the summary, ask if the user wants:
1. Full description text
2. Complete comment history
3. Raw JSON output
4. Specific field details
### Optional: Store Context
Store the full ticket context in the conversation for later reference. This allows the user to ask follow-up questions about the ticket without re-fetching data.
## Error Handling
- **acli not found**: Delegate to `acli-setup-check` skill
- **Authentication failure**: Delegate to `acli-setup-check` skill
- **Invalid ticket key**: Verify format and suggest correction
- **Ticket not found**: Verify the ticket exists and user has access
- **Permission denied**: Inform user they may not have access to the ticket or project
- **Network errors**: Report error and suggest retrying
## Examples
### Basic Usage
```text
User: /jira-workitem-view AIPCC-1234
Assistant: [Fetches and displays formatted ticket details]
User: We need to look at AIPCC-1234 to understand the bug
Assistant: Let me fetch the details for AIPCC-1234...
[Displays ticket information]
User: Show me the full description for AIPCC-1234
Assistant: [Fetches ticket and displays complete description text]
User: What's the status of AIPCC-1234?
Assistant: AIPCC-1234 is currently "In Progress" (updated 2024-03-20)
tools
Use this skill to filter a pre-fetched set of Hacker News stories down to those that report supply-chain security threats relevant to software developers — including malicious packages on npm or PyPI, compromised developer tooling, and attacks targeting source code repositories or CI/CD infrastructure. Reads stories from stories.json in the workspace, performs semantic analysis (fetching HN threads when the title alone is ambiguous), and writes the stories worth alerting on to findings.json.
development
Run hexora static analysis on a Python package repository to detect suspicious code patterns, then triage findings with deterministic rules and AI reasoning to produce a structured risk report section.
development
Inspect recent git history of a Python package repository for suspicious commits touching supply-chain-sensitive files, then triage findings with AI reasoning to produce a structured risk report section.
development
Scan a Python package repository for compiled/binary files using Fromager-style detection and malcontent YARA analysis, then triage findings with deterministic rules and AI reasoning to produce a structured risk report section.