[5/5] Aitools: project scope (--project/--global)

[simonfaltum]

PR Stack

1. [1/5] State + release discovery + directory rename ([1/5] Aitools: state tracking, manifest source, directory rename #4810)
2. [2/5] Install writes state + interactive agent selection ([2/5] Aitools: install writes state, interactive agent selection, idempotent install #4811)
3. [3/5] Update + uninstall + version commands ([3/5] Aitools: update, uninstall, and version commands #4812)
4. [4/5] List improvements + command restructuring + flags ([4/5] Aitools: list command, flat structure, --skills/--agents/--include-experimental flags #4813)
5. [5/5] Project scope (--project/--global) (this PR)

Manifest v2 PR: databricks/databricks-agent-skills#35

Base: simonfaltum/aitools-pr4-restructure (PR 4)

Why

Skills are currently global-only. Teams working on the same project can't share a curated set of skills via their repo. Project-scoped installation puts skills alongside the code, so they can be committed to git and shared.

Changes

Before: All skills install to ~/.databricks/aitools/skills/ (global only).

Now:

• --project flag on install, update, uninstall: operates on <cwd>/.databricks/aitools/skills/
• --global flag: explicit global scope (default behavior)
• --global + --project -> error
• Interactive scope prompt on install (default: global). Uses huh.NewSelect in cmd layer.
• Non-interactive defaults to global.
• SupportsProjectScope field on Agent struct. Only Claude Code and Cursor support project scope.
• Incompatible agents get a warning, not an error: "Skipped : does not support project-scoped skills."
• Version shows both scopes when both exist.
• State includes scope: "project" field for project installs.

Test plan

• --project installs to cwd-relative directory
• --global + --project -> error
• No flag, interactive -> scope prompt shown, default is global
• No flag, non-interactive -> global (no prompt)
• Incompatible agents warned, not errored
• Symlinks only created for capable agents in project scope
• Version shows both scopes when both exist
• SupportsProjectScope set correctly for all 6 agents
• All lint checks pass

[github-actions]

Suggested reviewers

Based on git history of the changed files, these people are best suited to review:

• @arsenyinfo -- recent work in experimental/aitools/cmd/, experimental/aitools/lib/installer/, experimental/aitools/lib/agents/

Confidence: high

Eligible reviewers

Based on CODEOWNERS, these people or teams could also review:

@databricks/eng-apps-devex, @lennartkats-db

_{Suggestions based on git history of 17 changed files (6 scored). See CODEOWNERS for path-specific ownership rules.}