comment-linear-issue

Invocation: User-invoked only (model invocation disabled)
Argument hint: <IDENTIFIER> --body TEXT | --body-file PATH [--print-payload] [--quiet]
Allowed tools: Bash, Read, Write
Source: skills/integrations/linear/comment-linear-issue/SKILL.md

Comment on a Linear Issue

!${CLAUDE_PLUGIN_ROOT}/scripts/config-read-context.sh !${CLAUDE_PLUGIN_ROOT}/scripts/config-read-skill-context.sh comment-linear-issue

Configuration: Set work.integration: linear in .accelerator/config.md.

Add a Markdown comment to a Linear issue via commentCreate. Work through the steps in order. This skill never auto-invokes — it only runs when the user explicitly types /comment-linear-issue.

The comment body comes ONLY from text the user typed this turn or a file path the user named this turn — never synthesised from prior context.

Step 1: Parse arguments

Read the issue identifier (positional) and the body source (--body TEXT or --body-file PATH).

Step 2: Generate the preview

${CLAUDE_PLUGIN_ROOT}/skills/integrations/linear/scripts/linear-comment-flow.sh \
  <IDENTIFIER> --body "..." --print-payload

If the helper exits non-zero (e.g. no body — E_COMMENT_NO_BODY), STOP and report the error.

Step 3: Render the preview

Show the operation (commentCreate), the target issue, and the Markdown body under:

Proposed Linear write — review before sending

Step 4: Confirm before writing

Ask:

Post this comment to Linear? Reply y to confirm, n to revise, anything else to abort.

On a clear yes, proceed. On no/revise, rebuild the preview. On anything ambiguous, abort with “Aborted — no Linear write was made.”

Step 5: Send and render

${CLAUDE_PLUGIN_ROOT}/skills/integrations/linear/scripts/linear-comment-flow.sh \
  <IDENTIFIER> --body "..."

Confirm the comment was posted.

!${CLAUDE_PLUGIN_ROOT}/scripts/config-read-skill-instructions.sh comment-linear-issue