Jira Access

Data & APIs

Access a Jira workspace (omeshkshatriya.atlassian.net) using provided email and API token to list, create, and transition issues. Use when the user wants to interact with their Jira instance via commands like "list open bugs" or "create a task". Trigger on any request that mentions Jira operations.

Install

openclaw skills install jira-access

Jira Access Skill

Overview

This skill provides a thin wrapper around Jira's REST API. It enables the assistant to:

List issues with JQL filters
Create new issues
Transition issues between statuses
Add comments or attachments

All operations are performed using the credentials supplied via environment variables to avoid storing secrets in source control.

Setup

Set environment variables in the runtime where the skill runs. For PowerShell (recommended):

$env:JIRA_DOMAIN = "omeshkshatriya.atlassian.net"
$env:JIRA_EMAIL = "omeshkshatriya@gmail.com"
$env:JIRA_API_TOKEN = "ATATT3xFfGF0cks7fxnFIDe..."   # full token (do not truncate)

For Command Prompt (cmd.exe):

set JIRA_DOMAIN=omeshkshatriya.atlassian.net
set JIRA_EMAIL=omeshkshatriya@gmail.com
set JIRA_API_TOKEN=ATATT3xFfGF0cks7fxnFIDe...   # full token (do not truncate)

Security note: Do not commit these values to the repository. Keep them in a secure profile, a .env file, or a CI secret store.

Ensure Python 3.9+ is installed on Windows and install the required dependency:
```
pip install requests
```

Usage

The skill is invoked through the jira command (a simple batch wrapper) followed by a sub‑command:

jira list "project = OMESH" – List issues matching a JQL query.
jira create "Bug" "Summary" "Description" – Create a new issue of type Bug.
jira transition <ISSUE-KEY> <STATUS> – Move an issue to a new status.
jira comment <ISSUE-KEY> "Your comment" – Add a comment.

Example

Create a small batch wrapper jira.bat in the jira-access folder to forward arguments to the Python script:

@echo off
python "%~dp0scripts\jira_cli.py" %*

jira list "assignee = currentUser() AND status = Open"

Will output a table of open issues assigned to the current user.

Implementation Details

The core logic lives in scripts/jira_cli.py. It reads the environment variables, builds HTTP requests, and prints JSON‑formatted results. The script is deliberately minimal to keep the skill lightweight.

Extending the Skill

Add more sub‑commands in jira_cli.py for bulk operations.
Create reference files under references/ for advanced JQL patterns.
Store reusable payload templates in assets/ if needed.

When Not to Use

If the user asks for actions outside Jira (e.g., Confluence, Bitbucket) this skill should not be triggered.

References

Jira REST API documentation