Skip to content

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

Draft
simonfaltum wants to merge 2 commits intosimonfaltum/aitools-pr4-restructurefrom
simonfaltum/aitools-pr5-impl
Draft

[5/5] Aitools: project scope (--project/--global)#4814
simonfaltum wants to merge 2 commits intosimonfaltum/aitools-pr4-restructurefrom
simonfaltum/aitools-pr5-impl

Conversation

@simonfaltum
Copy link
Member

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

Implements scope selection for aitools install, update, uninstall, and version
commands. Skills can now be installed to a project directory (cwd) instead of
only globally. Agents that support project scope (Claude Code, Cursor) get
symlinks from their project config dirs to the canonical project skills dir.

Co-authored-by: Isaac
…agent guard, param cleanup

Co-authored-by: Isaac
@simonfaltum simonfaltum force-pushed the simonfaltum/aitools-pr4-restructure branch from f2fba9a to 1243dc4 Compare March 22, 2026 10:44
@simonfaltum simonfaltum force-pushed the simonfaltum/aitools-pr5-impl branch from b2584d2 to 47f3578 Compare March 22, 2026 10:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant