Transition a Linear Issue
!accelerator config context --skill transition-linear-issue --fail-safe
Configuration: Set
work.integration: linearin.accelerator/config.md.
Move a Linear issue to a target WorkflowState via issueUpdate, resolving the
state name to its team-scoped UUID from the cached catalogue — there is no
live lookup. Work through the steps in order. This skill never auto-invokes.
Step 1: Parse arguments
Read the issue identifier and the target state name (both positional, e.g.
/transition-linear-issue BLA-123 "In Progress").
Step 2: Render the preview
Show the resolved intent — the operation (issueUpdate state change), the target
issue, and the target state name — under:
Proposed Linear write — review before sending
State matching is case-insensitive and trimmed. Resolution happens inside the
subcommand from the cached catalogue; a name that is not in the catalogue or is
shared by two states is refused at send time before any write
(E_TRANSITION_STATE_NOT_IN_CATALOGUE, E_TRANSITION_STATE_AMBIGUOUS).
Step 3: Confirm before writing
Ask:
Transition this issue? Reply y to confirm, n to revise, anything else to abort.
On a clear yes, proceed. On anything ambiguous, abort with "Aborted — no Linear write was made."
Step 4: Send and render
accelerator linear transition <IDENTIFIER> "<STATE-NAME>"
The subcommand emits a JSON envelope with a top-level outcome keyword. On
transitioned, confirm the new state and suggest /show-linear-issue <IDENTIFIER> to verify. On a non-zero exit naming
E_TRANSITION_STATE_NOT_IN_CATALOGUE or E_TRANSITION_STATE_AMBIGUOUS, the
state could not be resolved and no write was made — suggest /init-linear to
refresh, or ask the user to pick an unambiguous state.
!accelerator config instructions transition-linear-issue --fail-safe