# Jira

> Read and write Jira issues, comments, transitions via the Jira REST API v3.

- Skill: `xaiht/jira` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xaiht/jira`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xaiht/jira/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: XAIHT (https://skillmd.com/u/xaiht)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/xaiht/jira

---

<!--
═══════════════════════════════════════════════════════════════════
  ✦  T L A M A T I N I  ✦   —   "one who knows"
  Created by  Angela López Mendoza   ·   @angelahack1
  Developer · Architect · Creator of Tlamatini
  Tlamatini Author Banner — do not remove (Angela's name is kept in every build)
═══════════════════════════════════════════════════════════════════
-->

# Jira skill

Use the Jira REST API v3 for issues / comments / transitions.

## Setup

`JIRA_BASE_URL` (e.g. `https://your-domain.atlassian.net`),
`JIRA_EMAIL` and `JIRA_API_TOKEN` must be in env.

## Procedure

- `search` → `POST /rest/api/3/search` with JQL in payload.
- `get`    → `GET /rest/api/3/issue/{key}`.
- `create` → `POST /rest/api/3/issue` with `{ fields: {...} }`.
- `comment`→ `POST /rest/api/3/issue/{key}/comment`.
- `transition`→ `POST /rest/api/3/issue/{key}/transitions`.

Use Basic Auth: `base64(JIRA_EMAIL:JIRA_API_TOKEN)`.

Return the parsed JSON.