---
title: "mk:jira-collaborate"
description: "Manage JIRA collaboration: comments, attachments, watchers, notifications. Internal-vs-public comment safety enforced."
---

# mk:jira-collaborate

## What This Skill Does

Forks the `jira-collaborate` agent to manage the per-issue collaboration layer — comments, attachments, watchers, notifications. The agent confirms internal-vs-public for any comment that could be customer-facing.

## When to Use

- **Triggers:** "add comment to PROJ-123", "list comments on PROJ-123", "upload screenshot.png to PROJ-123", "watch PROJ-123", "notify watchers"
- **NOT for:** issue CRUD ([`mk:jira-issue`](/reference/skills/jira-issue)), issue links ([`mk:jira-relationships`](/reference/skills/jira-relationships)), transitions ([`mk:jira-lifecycle`](/reference/skills/jira-lifecycle)).

## Internal-vs-Public Safety

Atlassian Cloud distinguishes **internal** (team-only) vs **public** (visible to customers / external watchers) comments. JSM tickets surface this distinction explicitly. Before posting any customer-facing comment:

> "Should this comment be `internal` (team-only) or `public` (visible to all watchers)?"

Default to `internal` if uncertain. Misposting an internal comment as public has reputational + privacy consequences.

## Verified Wrapper Invocations

| Operation | Tier | Invocation |
|---|---|---|
| Comment add | 2 | `... collaborate comment add PROJ-123 --body "text"` |
| Comment list | 1 | `... collaborate comment list PROJ-123` |
| Comment delete | 4 | `... collaborate comment delete PROJ-123 --comment-id <ID>` (irreversible) |
| Attachment upload | 2 | `... collaborate attachment upload PROJ-123 --file /path/to/file` |
| Attachment download | 1 | `... collaborate attachment download PROJ-123 --attachment-id <ID> --output /tmp/...` |
| Watcher add | 2 | `... collaborate watcher add PROJ-123 --user <username>` |
| Notify | 2 | `... collaborate notify PROJ-123 --message "..."` |

## ADF Conversion

Pass markdown to `--body` and `jira-as` handles ADF conversion server-side. For raw ADF, pass `--format adf` with a JSON ADF document.

## Domain References

- `references/comment-templates.md` — copy-paste comment templates (progress, blocker, handoff, evidence)
- `references/comment-formats.md` — text / markdown / ADF format reference

## Peer Leaves

`mk:jira-issue` (create-with-attachment) · `mk:jira-jsm` (internal-vs-public on JSM tickets) · `mk:jira-analyst` (post-analysis comment patterns)

## Agent

[`jira-collaborate`](/reference/agents/jira-collaborate) — A + C, NOT B.
