[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 link, sync tools link, and sync skills link via a shared newLinkCmd builder. Each command takes --file, --format, optional --select and repeatable --map field=path, targets exactly one resource (--project, one --key, and --config-key for variations), then runs SourceLinkAction to write a .ref.yaml descriptor and sync.

Sync CLI errors now serialize structured Problem values: ProblemsFrom walks joined/plan errors, JSON keeps stable fields (or a multiple_problems wrapper with a problems array), and plaintext inlines resource and file:line:column into messages.

Tests cover link flag wiring, target validation, error rendering (JSON vs plaintext), exact flag sets for the new subcommands, and an acceptance path that links a markdown source then detaches the descriptor.

^{Reviewed by Cursor Bugbot for commit 88afafc. 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.}