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.

2. 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 <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:

bat

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

bash

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

---