jira-collaborate_skill

Overview

This skill provides collaboration tools for JIRA issues: manage comments, attachments, watchers, notifications, and view activity history. It is designed for team communication and coordination around issue work without touching workflow transitions. Always run commands through the jira-as CLI as documented.

How this skill works

The skill exposes CLI commands to add, update, list, and delete comments (including role/group visibility and rich-text formats). It supports uploading, listing, and downloading attachments, managing watchers, sending targeted notifications, and querying the issue changelog. Commands accept JSON or text outputs and include pagination and preview/dry-run options for safer operations.

When to use it

• Posting progress updates, internal notes, or technical explanations on an issue
• Uploading or retrieving evidence files, logs, or screenshots tied to an issue
• Adding or removing watchers to ensure the right people are notified
• Sending targeted notifications to users, groups, assignee, or reporter
• Reviewing activity history or changelog to audit recent changes
• Updating custom fields while collaborating on issue details

Best practices

• Use --dry-run or preview options before destructive operations like delete
• Prefer account IDs (not emails) for watcher and notify commands to avoid ambiguity
• Use visibility-role or visibility-group for internal-only comments
• List comments or attachments first to confirm IDs before update/delete
• Run all operations via the jira-as CLI; do not execute underlying scripts directly

Example use cases

• Add a rich-text progress comment and notify watchers that work has started
• Upload a screenshot as evidence and link it in a follow-up comment
• List recent activity to prepare handoff notes for the next assignee
• Remove an external watcher after issue confidentiality changes
• Preview a notification to confirm recipients before sending to a large group