[4/5] Aitools: list command, flat structure, --skills/--agents/--include-experimental flags

[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 (this PR)
5. [5/5] Project scope (--project/--global) ([5/5] Aitools: project scope (--project/--global) #4814)

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

Base: simonfaltum/aitools-pr3-lifecycle (PR 3)

Why

Commands are nested under skills which burns namespace for future component types (hooks, etc.). There's no way to install specific skills, target specific agents from the CLI, or see installed status in the list output.

Changes

New list command: Table output with skill names, versions, installed status, [experimental] tags. Sorted alphabetically. Uses tabwriter for alignment.

Flat command structure: aitools install/update/uninstall/list/version at the top level. Hidden skills install and skills list aliases for backward compat.

Flags:

• --skills (string, comma-separated) on install, update, uninstall: operate on specific skills
• --skills (bool) on list, version: show detailed skills view
• --agents (string, comma-separated) on install: target specific agents, validates against registry, skips interactive prompt
• --include-experimental on install: include experimental skills

Selective uninstall: --skills on uninstall removes only named skills, preserves state file with remaining.

Test plan

• install --skills, --agents, --include-experimental flags work
• --agents validates against registry, errors on unknown
• uninstall --skills selective removal, state preserved
• update --skills selective update
• list shows detailed table
• skills install and skills list hidden aliases work (Execute path tested)
• cmd/apps/init.go integration preserved
• 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/

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 12 changed files (5 scored). See CODEOWNERS for path-specific ownership rules.}