Agent-Skills.md

Agent Skills: Jira Communication

>

UncategorizedID: questnova502/claude-skills-sync/jira-communication

Repository

questnova502/claude-skills-sync
QuestNova502
34

Install this agent skill to your local

pnpm dlx add-skill https://github.com/QuestNova502/claude-skills-sync/tree/HEAD/skills/jira-integration/skills/jira-communication

Skill Files

Browse the full folder contents for jira-communication.

Download Skill

Loading file tree…

skills/jira-integration/skills/jira-communication/SKILL.md

Skill Metadata

Name
jira-communication
Description
>

Jira Communication

CLI scripts for Jira operations using uv run. All scripts support --help, --json, --quiet, --debug.

Auto-Trigger

Trigger when user mentions:

  • Jira URLs: https://jira.*/browse/*, https://*.atlassian.net/browse/*
  • Issue keys: PROJ-123, NRS-4167

When triggered by URL → extract issue key → run jira-issue.py get PROJ-123

Auth Failure Handling

When auth fails, offer: uv run scripts/core/jira-setup.py (interactive credential setup)

Scripts

| Script | Purpose | |--------|---------| | scripts/core/jira-setup.py | Interactive credential config | | scripts/core/jira-validate.py | Verify connection | | scripts/core/jira-issue.py | Get/update issue details | | scripts/core/jira-search.py | Search with JQL | | scripts/core/jira-worklog.py | Time tracking | | scripts/core/jira-attachment.py | Download attachments | | scripts/workflow/jira-create.py | Create issues | | scripts/workflow/jira-transition.py | Change status | | scripts/workflow/jira-comment.py | Add comments | | scripts/workflow/jira-sprint.py | List sprints | | scripts/workflow/jira-board.py | List boards | | scripts/utility/jira-user.py | User info | | scripts/utility/jira-fields.py | Search fields | | scripts/utility/jira-link.py | Issue links |

Critical: Flag Ordering

Global flags MUST come before subcommand:

# Correct:  uv run scripts/core/jira-issue.py --json get PROJ-123
# Wrong:    uv run scripts/core/jira-issue.py get PROJ-123 --json

Quick Examples

uv run scripts/core/jira-validate.py --verbose
uv run scripts/core/jira-search.py query "assignee = currentUser()"
uv run scripts/core/jira-issue.py get PROJ-123
uv run scripts/core/jira-worklog.py add PROJ-123 2h --comment "Work done"
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run

Related Skills

jira-syntax: For descriptions/comments. Jira uses wiki markup, NOT Markdown.

References

  • references/jql-quick-reference.md - JQL syntax
  • references/troubleshooting.md - Setup and auth issues

Authentication

Cloud: JIRA_URL + JIRA_USERNAME + JIRA_API_TOKEN Server/DC: JIRA_URL + JIRA_PERSONAL_TOKEN

Config via ~/.env.jira or env vars. Run jira-validate.py --verbose to verify.

Jira Communication Skill | Agent Skills