# Jira Issue Sync

> Sync Jira issues with local tasks. Use during daily planning or when user asks about Jira issues.

- Skill: `itseffi/jira-issue-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add itseffi/jira-issue-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/itseffi/jira-issue-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: itseffi (https://skillmd.com/u/itseffi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/itseffi/jira-issue-sync

---


# Jira Issue Sync

Check Jira for assigned issues and sync with local task management.

## Instructions

### Step 1: Fetch Assigned Issues

Call `jira_search` with JQL:
```
assignee = currentUser() AND status != Done ORDER BY priority DESC
```

### Step 2: Compare with Local Tasks

Check `Tasks/` for existing files with Jira references:
- Look for `jira_key` in YAML frontmatter
- Identify new issues not yet in Tasks/

### Step 3: Present Summary

```
Jira Issues (8 active):

**Blockers/Critical**
- PROJ-123: Production bug in auth [In Progress]

**High Priority**
- PROJ-124: API rate limiting [To Do]
- PROJ-125: Update deployment docs [In Review]

**Normal**
- PROJ-126: Refactor logging [Backlog]

3 issues not yet in local Tasks. Create them?
```

### Step 4: Sync Options

| Option | Description |
|--------|-------------|
| Create all | Add all new issues as local tasks |
| Select specific | Choose which to sync |
| Skip | Continue without syncing |

### Step 5: Create Local Tasks

For each issue to sync, create task file:

```yaml
---
title: [Issue summary]
category: technical
priority: [Map from Jira priority]
status: n
jira_key: PROJ-XXX
---
```

## Priority Mapping

| Jira | Personal OS |
|------|-------------|
| Blocker | P0 |
| Critical | P0 |
| High | P1 |
| Medium | P2 |
| Low | P3 |

## Example Flow

**User:** "What should I work on today?"

**Agent:**
1. Fetches Jira issues
2. Compares with local tasks
3. "You have 5 Jira tickets..."
4. Offers to create local tasks
5. Continues with planning

## Notes

- Keep `jira_key` in frontmatter for bidirectional sync
- Update Jira status when local task completes
- Include Jira link in task context section