netresearch/agent-jira-skill

Claude Code skills for Jira API operations and wiki markup syntax

Maintainers

Details

github.com/netresearch/jira-skill

Source

Issues

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 1

Open Issues: 0

Language:Python

Type:ai-agent-skill

pkg:composer/netresearch/agent-jira-skill

v3.0.2 2025-11-26 13:31 UTC

Requires

MIT 6dbeb2c3baa3be75e016fc5690ca9cf8f7f2a014

This package is auto-updated.

Last update: 2025-11-26 13:48:28 UTC

README

Comprehensive Jira integration through lightweight Python scripts.

Features

  • Zero MCP overhead - Scripts invoked via Bash, no tool descriptions loaded
  • Fast execution - No Docker container spin-up
  • Full API coverage - All common Jira operations supported
  • Jira Server/DC + Cloud - Works with both deployment types

Installation

  1. Install uv (Python package runner):

    curl -LsSf https://astral.sh/uv/install.sh | sh

  2. Configure credentials in ~/.env.jira:

    JIRA_URL=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-api-token

    For Jira Server/DC with Personal Access Token:

    JIRA_URL=https://jira.yourcompany.com
JIRA_PERSONAL_TOKEN=your-personal-access-token

  3. Validate setup:

    uv run scripts/core/jira-validate.py --verbose

Quick Start

# Search issues
uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'"

# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123

# Add worklog
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Code review"

# Create issue
uv run scripts/workflow/jira-create.py issue PROJ "Fix bug" --type Bug --priority High

Available Scripts

Core Operations (scripts/core/)

Script Commands Usage
jira-validate.py (default) Validate environment setup
jira-issue.py get, update Get and update issues
jira-search.py query JQL search
jira-worklog.py add, list Time tracking

Workflow Operations (scripts/workflow/)

Script Commands Usage
jira-create.py issue Create new issues
jira-transition.py list, do Change issue status
jira-comment.py add, list Issue comments
jira-sprint.py list, issues, current Sprint operations
jira-board.py list, issues Board operations

Utility Operations (scripts/utility/)

Script Commands Usage
jira-fields.py search, list Find field IDs
jira-user.py me, get User information
jira-link.py create, list-types Issue linking

Common Options

All scripts support:

  • --json - Output as JSON
  • --quiet / -q - Minimal output
  • --env-file PATH - Custom environment file
  • --debug - Show detailed errors
  • --help - Show command help

Write operations also support:

  • --dry-run - Preview changes without executing

Script Usage Examples

Search and Filter

# Find open bugs in project
uv run scripts/core/jira-search.py query "project = PROJ AND type = Bug AND status != Done"

# Find my assigned issues
uv run scripts/core/jira-search.py query "assignee = currentUser()"

# Output as JSON for processing
uv run scripts/core/jira-search.py query "project = PROJ" --json --max-results 100

Issue Management

# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123

# Update issue fields (dry-run first)
uv run scripts/core/jira-issue.py update PROJ-123 --labels "urgent,backend" --dry-run

# Create new issue
uv run scripts/workflow/jira-create.py issue PROJ "Implement feature X" --type Story --priority Medium

Time Tracking

# Log time worked
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Implemented core logic"

# View worklogs
uv run scripts/core/jira-worklog.py list PROJ-123

Workflow Transitions

# List available transitions
uv run scripts/workflow/jira-transition.py list PROJ-123

# Transition issue (dry-run first)
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run

# Execute transition
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress"

Comments

# Add comment
uv run scripts/workflow/jira-comment.py add PROJ-123 "Investigation complete - root cause identified"

# List recent comments
uv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5

Sprint & Board Operations

# List boards for project
uv run scripts/workflow/jira-board.py list --project PROJ

# Get board issues
uv run scripts/workflow/jira-board.py issues 42

# List sprints
uv run scripts/workflow/jira-sprint.py list 42 --state active

# Get sprint issues
uv run scripts/workflow/jira-sprint.py issues 123

# Get current sprint
uv run scripts/workflow/jira-sprint.py current 42

Utility Operations

# Search for custom fields
uv run scripts/utility/jira-fields.py search "story points"

# List all custom fields
uv run scripts/utility/jira-fields.py list --type custom

# Get current user info
uv run scripts/utility/jira-user.py me

# List available link types
uv run scripts/utility/jira-link.py list-types

# Create issue link
uv run scripts/utility/jira-link.py create PROJ-123 PROJ-456 --type "Blocks" --dry-run

Related Skills

  • jira-syntax - Jira wiki markup validation and templates (unchanged)

Migration

Migrating from v2.x (MCP-based)? See Migration Guide.

Troubleshooting

"uv not found"

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

"Environment file not found"

Create ~/.env.jira with your credentials.

"Authentication failed"

  1. Verify JIRA_URL is correct
  2. For Cloud: JIRA_USERNAME is your email
  3. For Server/DC: Use JIRA_PERSONAL_TOKEN instead
  4. Regenerate your API token if expired

Import errors when running scripts

Run scripts from the skill directory:

cd skills/jira-communication
uv run scripts/core/jira-issue.py get PROJ-123

License

MIT