Skip to main content

Skills Commands

pan skills lists skills and sets per-level on/off overrides for native skills and skill packs. See Skills for the on/off levels and Skill Packs for what a pack is, the pack catalog, and the trust model.

pan skills list

Lists skills with their effective on/off state and the level that decided it, then skill packs and their skills. This is the default command: pan skills alone runs it.
Exits 1 if the override files cannot be read.

pan skills set

Sets a native skill, a pack skill (<pack>/<skill>), or a whole pack to on, off, or inherit, at the global, project, or issue level.
Takes exactly one positional (the state) with --pack, two (the skill and the state) without it. Exits 1 on the wrong positional count, a state that is not on, off, or inherit, passing --project and --issue together, or an unreadable override file.

pan skills pack add

Registers a git skill pack at the commit a ref resolves to and trusts it; enables nothing. Known packs (mattpocock, pstack, gstack, deft, sageox) default the url and, for pstack, the ref.
Exits 1 on an unknown --adapter value, a pack with no default url or ref when none is given, a pack source error, or when the commit was not trusted (declined, or not written without a terminal and --yes). With --browser, the pack is registered as soon as the commit is trusted; a declined or failed browser-runtime step then exits 1 with the pack already registered. Finish it with pan skills pack browser <id> rather than retrying pack add.

pan skills pack update

Moves a pack to the commit its ref (or --ref) now resolves to, after showing the preview again.
Exits 1 on a pack source error, or when the new commit was not trusted.

pan skills pack list

Lists registered skill packs with their source, cache state, license, skill count, and what is not applied.

pan skills pack remove

Unregisters a pack, clears its global toggles, and deletes its cache, every mount that contains it, and dangling launch links, and Codex plugin caches.
Exits 1 if the pack is not registered, or if removing a mount or cache failed (rerun to retry). The unregister step runs before the cache and mount sweep, so a retry after a failed sweep still exits 1 with “pack is not registered” even when that retry’s sweep itself succeeds; that exit does not by itself mean the cleanup failed.

pan skills pack sync

Re-fetches a pack and extracts its trusted commit, or every registered pack when id is omitted.
Exits 1 if any pack fails to sync.

pan skills pack gc

Removes unused skill pack mounts, dangling launch links, stale renders, and orphaned pack state for packs that are no longer registered.
Exits 1 if --max-age-days is not a number of days of 0 or more, or if the global config cannot be read or parsed (gc then removes nothing).

pan skills pack browser

Turns a runtime pack’s browser runtime on or off (gstack only). state defaults to on.
Exits 1 if state is not on or off, on a pack source error, or when the browser runtime was not trusted.

pan skills pack sageox status

Shows, per project, whether the sageox pack is on and whether uploads are enabled.
Exits 1 if --project names a project Overdeck does not know.

pan skills pack sageox upload

Turns SageOx uploads on or off for a project. Uploads are off by default.
Exits 1 if state is not on or off, or on a SageOx config error.

pan skills deft status

Shows Directive detection, the deft pack, the skill map, managed mode, and the ownership report for a project (the current repository when --project is omitted).
Exits 1 if --project names a project Overdeck does not know.

pan skills deft enable

Prints the ownership plan for a Directive project and, once accepted, stores the decision to enable managed mode.
Exits 1 if --project names an unknown project, the project is not a Directive project, or the plan was not accepted.

pan skills deft disable

Removes the managed-mode decision for a project. Project files are untouched.
Exits 1 if --project names a project Overdeck does not know.