jira-communication

The jira-communication skill provides a robust CLI-based interface for interacting with Atlassian Jira environments, including both Cloud and Server/Data Center deployments. Designed for developers and project managers who prefer working within the terminal, this skill executes operations through specialized Python scripts managed by uv. It effectively serves as a powerful alternative when MCP tools are unavailable or require more granular control over Jira API interactions. By providing native auto-triggering on Jira URLs and project-specific issue keys like PROJ-123, it enables seamless context-aware workflows that minimize manual task switching.

• Full support for core issue management operations including creating, updating, moving, transitioning, and deleting issues.

• Advanced search capabilities leveraging Jira Query Language (JQL) to filter tickets by status, assignee, or custom criteria.

• Integrated time tracking features for adding and querying worklogs directly from the CLI.

• Comprehensive agile management tools for querying sprint data, board contents, and version releases.

• Attachment handling, allowing for secure uploading and downloading of files associated with issues.

• Utility functions to manage issue links, watchers, user information, and custom field lookups.

• Context-aware validation and setup scripts to ensure environment variables and API credentials are correctly configured.

• The skill relies on uv to manage dependencies and execute scripts, requiring Python 3.10+ in the runtime environment.

• Authentication supports JIRA_URL, JIRA_USERNAME, and API tokens, with configuration handled via .env.jira or profiles.json files.

• Destructive operations, such as updates or deletions, should be executed with the --dry-run flag to preview changes before they are committed.

• Output formats can be toggled using --json for integration with downstream data processing tools or scripts.

• The tool is designed to be compatible with Jira's wiki markup; users should coordinate with the jira-syntax skill for complex formatted content input.

• Security best practices are implemented, including SSRF protection for attachment downloads and standardized error reporting via --debug mode.