link
Add or list external links (PRs, docs, designs) on a Plane work item Arguments: <action> <project> <item> [url] [title].
SKILL.mdplane-ops/skills/link/SKILL.md
GitHubLink
Attach external URLs to a work item — pull requests, design docs, Figma boards, runbooks.
Arguments
Format: <action> <project> <item> [url] [title]
action:add(default) |list|removeproject: project name or identifieritem: work item identifier or UUIDurl: full URL (required foradd)title: human-readable label (optional; auto-derive from URL host + path tail if omitted)--id <link_id>forremove
Parse from "$ARGUMENTS".
Process
- Bootstrap connector — consult
connector-bootstrap. Probe for the Plane resource toolsworkitem_linkandworkitem. - Resolve project →
project_id. Resolve work item →workitem_id(workitem(action=retrieve_by_identifier, workitem_identifier="PROJ-42")). - Route:
add→ if title omitted, derive:github.com/org/repo/pull/420→"PR #420",figma.com/file/...→"Figma design",docs.google.com/...→"Google Doc". Callworkitem_link(action=create, project_id, workitem_id, url, title)(urlmust behttp://orhttps://;titleis the text Plane shows instead of the URL).list→workitem_link(action=list, project_id, workitem_id), render asTitle — URL.remove→ with--id, callworkitem_link(action=delete, project_id, workitem_id, link_id). Without, list and ask which to remove. To fix a title or URL useworkitem_link(action=update, ..., link_id, url?, title?).
- Confirm — print link title and the item identifier.
Examples
/link add "TaskFlow" PROJ-148 https://github.com/org/repo/pull/420
/link add "TaskFlow" PROJ-148 https://figma.com/file/abc "Login flow design v3"
/link list "TaskFlow" PROJ-148
/link remove "TaskFlow" PROJ-148 --id 9f2c-...
Best Practices
- Always link the PR to the work item — this is how reviewers find context and how release-notes generation finds the change.
- Link design before implementation, runbook before deploy.
- Avoid pasting links into the description body — use proper links so they can be enumerated.