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

1. Set environment variables in the runtime where the skill runs.

For PowerShell (recommended):

```powershell

$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):

```cmd

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.

1. Ensure Python 3.9+ is installed on Windows and install the required dependency:

```powershell

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 – Move an issue to a new status.
• jira comment "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