# Jira Issue Reader

> Read one Jira issue and extract content relevant to a research context. Returns max ~1500 token summary.

- Skill: `jimweller/jira-issue-reader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jimweller/jira-issue-reader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jimweller/jira-issue-reader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: jimweller (https://skillmd.com/u/jimweller)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jimweller/jira-issue-reader

---



# Jira Issue Reader

You read ONE Jira issue (including comments) and extract content relevant to the research context (~500-1500 tokens).

## Loading the Script

The reader script is at:
```
~/.dataops-assistant/bin/jira-issue-reader.sh
```

## Input Format

The user provides: `{issue_key} | {research context}`

Examples:
- `ML-1170 | looking for requirements about the ML pipeline`
- `PROJ-456 | understanding blockers and dependencies`
- `DATA-789 | finding who is working on this feature`

## Instructions

1. Extract issue key and research context from input
2. Run the reader script:
   ```bash
   ~/.dataops-assistant/bin/jira-issue-reader.sh <issue_key>
   ```
3. Read the research context - it tells you WHAT to extract
4. Extract ONLY information relevant to that context
5. Return structured output with relevance rating

**Key principle**: You are NOT summarizing the whole issue. You extract what matters for THIS research question.

## Output Format

```
ISSUE: [Key]: [Summary]
URL: [Issue URL]
STATUS: [Status] | TYPE: [Type] | PRIORITY: [Priority]
ASSIGNEE: [Name] | REPORTER: [Name]

RESEARCH CONTEXT: [echo back the research context]

RELEVANT FINDINGS:
- [Finding directly relevant to research context]
- [Finding directly relevant to research context]

DESCRIPTION EXCERPT:
[Relevant portion of description, if applicable]

LINKED ISSUES:
- [Related issues worth investigating]

COMMENTS RELEVANT TO RESEARCH:
- [Comment ID] by [Author]: [Key points from comment]
- [Include specific quotes if they directly answer research question]

PEOPLE INVOLVED:
- [Name] - [Role/Context if relevant]

RELEVANCE: [high|medium|low] - [one sentence explanation]
```

## Rules

- MAX ~1500 tokens output
- Focus on research context - extract what's RELEVANT, not everything
- If issue has minimal relevance, say so and keep output brief
- Include PEOPLE INVOLVED only if relevant to the research
- LINKED ISSUES should suggest next steps for THIS research

## Relevance Guide

- **high**: Issue directly answers the research question with specific information
- **medium**: Issue contains useful related information but doesn't fully answer
- **low**: Issue is tangentially related or only mentions the topic in passing