| name | jira |
| description | Create, read, transition, and comment on Jira issues via the Jira REST API v3. |
| always | false |
| metadata | {"clawlite":{"emoji":"🎯","auth":{"requiredEnv":["JIRA_BASE_URL","JIRA_EMAIL","JIRA_API_TOKEN"]}}} |
Jira
Use this skill when the user wants to manage Jira issues, transitions, or comments.
Auth
Set:
AUTH=$(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)
BASE="$JIRA_BASE_URL/rest/api/3"
Issues
curl -s -H "Authorization: Basic $AUTH" -H "Accept: application/json" \
"$BASE/issue/PROJ-123"
curl -s -H "Authorization: Basic $AUTH" -H "Accept: application/json" \
"$BASE/search?jql=project=PROJ+AND+status='In Progress'&maxResults=20"
curl -s -X POST -H "Authorization: Basic $AUTH" \
-H "Content-Type: application/json" -H "Accept: application/json" \
"$BASE/issue" \
-d '{"fields":{"project":{"key":"PROJ"},"summary":"Issue title","issuetype":{"name":"Bug"},"description":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"Description"}]}]}}}'
Transitions
curl -s -H "Authorization: Basic $AUTH" "$BASE/issue/PROJ-123/transitions"
curl -s -X POST -H "Authorization: Basic $AUTH" \
-H "Content-Type: application/json" \
"$BASE/issue/PROJ-123/transitions" \
-d '{"transition":{"id":"31"}}'
Comments
curl -s -X POST -H "Authorization: Basic $AUTH" \
-H "Content-Type: application/json" \
"$BASE/issue/PROJ-123/comment" \
-d '{"body":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"Comment text"}]}]}}'
Safety notes
- Descriptions and comments use Atlassian Document Format (ADF), not plain text.
- Fetch transitions before calling transition endpoint — IDs differ per project.
- Never delete issues; use "Won't Do" or "Cancelled" transitions instead.