[ctawiah]

Context

Users need one link command for each resource kind.

What changes

• Add sync prompts link, sync tools link, and sync skills link from one command builder.
• Read the --file, --format, --select, and --map flags and run the link workflow.
• Add the CLI acceptance test for link and detach.

Design notes

• The three commands share one implementation. Only the target flags and the examples differ.

Review focus

• Do all three resource kinds use one workflow?
• Do plain text and JSON show the same problem?

Verification

• make build
• go test ./...
• golangci-lint run ./...

Related changes

1. refactor(sync): remove Phase 1 source references #1005: Phase 1 reference removal
2. feat(sync): add projection and problem core #987: projection and problem core
3. feat(sync): add the adapter core and the Markdown adapter #988: adapter core and Markdown
4. feat(sync): add the structured document adapters #989: structured adapters
5. feat(sync): add the Python adapter #991: Python adapter
6. feat(sync): add the TypeScript and JavaScript adapters #992: TypeScript and JavaScript adapters
7. feat(sync): add source descriptor storage #993: descriptor storage
8. feat(sync): compile and publish repository sources #994: compile and publish
9. feat(sync): detach descriptor-backed sources #1003: descriptor detach
10. feat(sync): prepare repository source links #997: link preparation
11. feat(sync): integrate repository sources with planning and link #995: planning and link
12. This PR: link commands

🤖 Generated with Claude Code

---

Note

Overview
Adds sync prompts|tools|skills link via a shared newLinkCmd builder that reads --file, --format, optional --select, and repeatable --map field=path, validates exactly one target (--project, --key, plus --config-key for variations), and runs SourceLinkAction to write a .ref.yaml descriptor and sync.

Sync command errors now route through syncCommandOutputError, which emits structured Problem JSON (including multiple_problems with a problems array) and richer plaintext that includes resource and file location. ProblemsFrom collects problems from joined error trees.

Tests cover link flag wiring, target validation, error rendering, exact flag sets for link subcommands, and an acceptance test for link + detach.

^{Reviewed by Cursor Bugbot for commit 0534c82. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 9a64de9. Configure here.}