SKILL.md
/linear-update — Update a Linear issue
Push updates to a Linear issue using schpet/linear-cli.
Steps
- Verify the Linear CLI is available:
``bash linear --version 2>/dev/null || echo "LINEARCLIMISSING" ``
- Parse
$ARGUMENTSfor the issue ID and field updates:
- First token: issue ID (e.g., ENG-123) - Remaining tokens: field=value pairs (e.g., status=done priority=high)
If no arguments, ask the user for the issue ID and what to update.
- Fetch the current issue state:
``bash linear issue view ENG-123 --json ``
- Show the proposed changes for confirmation:
``` ## Update: ENG-123 — <title>
| Field | Current | New |
|---|---|---|
| Status | In Progress | Done |
| Priority | Medium (3) | High (2) |
Apply these changes? ```
- Apply the update using
linear issue updatewith the appropriate flags:
``bash linear issue update ENG-123 --state "Done" --priority 2 ``
Available flags (use linear issue update --help for full list): - --state "<state-name>" — set workflow state (e.g., "Todo", "In Progress", "Done") - --priority <number> — set priority (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low) - --assignee "<username-or-email>" — assign to user (use @me for self) - --label "<label-name>" — add label (repeat flag for multiple) - -t "<title>" — update title - -d "<description>" — update description
- Report:
``` Updated: ENG-123 — <title> Changes: state → Done, priority → High
Run /linear-sync to update the local snapshot. ```
Arguments
$ARGUMENTSformat:<issue-id> [state=<state>] [priority=<priority>] [assignee=<name>]- Examples:
- ENG-123 state=done — mark as done - ENG-123 priority=urgent assignee=@me — set priority and self-assign - ENG-123 label=bug label=regression — add labels
Notes
- Always show current vs proposed state and confirm before applying
- When marking an issue as Done, ask if a comment should be added (e.g., linking to the PR):
linear issue comment add ENG-123 -b "Fixed in PR #42"
- Run
/linear-syncafter updates to refresh the local snapshot - If the issue doesn't exist in Linear, report the error clearly