> ## Documentation Index > Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt > Use this file to discover all available pages before exploring further. # Skills Commands > List skills, set on/off overrides, and manage skill packs # Skills Commands `pan skills` lists skills and sets per-level on/off overrides for native skills and skill packs. See [Skills](https://panopticon-cli.com/features/skills.md) for the on/off levels and [Skill Packs](https://panopticon-cli.com/features/skill-packs.md) for what a pack is, the pack catalog, and the trust model. ## pan skills list ```bash theme={null} pan skills list [--project ] [--issue ] [--json] ``` 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. | Flag | Effect | | - | - | | `--project ` | Resolve for a project | | `--issue ` | Resolve for an issue | | `--json` | Output as JSON (only the skill array; packs and pack skills are not included) | ```bash theme={null} pan skills list --project myapp ``` Exits 1 if the override files cannot be read. ## pan skills set ```bash theme={null} pan skills set pan skills set --pack ``` Sets a native skill, a pack skill (`/`), or a whole pack to `on`, `off`, or `inherit`, at the global, project, or issue level. | Flag | Effect | | - | - | | `--project ` | Project override | | `--issue ` | Issue override | | `--pack ` | Set a whole skill pack instead of one skill | ```bash theme={null} pan skills set mattpocock/grilling on --project myapp ``` 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 ```bash theme={null} pan skills pack add [url] [--ref ] [--adapter ] [--browser] [--yes] ``` 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. | Flag | Effect | | - | - | | `--ref ` | Tag, branch or commit to pin (default: the known pack ref) | | `--adapter ` | `plain`, `claude-plugin`, `deft-readonly`, or `gstack-runtime` | | `--browser` | Also build the browser runtime (gstack; asks separately) | | `--yes` | Trust the resolved commit without asking; with `--browser`, also accepts the browser runtime's consent | ```bash theme={null} pan skills pack add mattpocock --ref v1.2.3 ``` 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 ` rather than retrying `pack add`. ## pan skills pack update ```bash theme={null} pan skills pack update [--ref ] [--yes] ``` Moves a pack to the commit its ref (or `--ref`) now resolves to, after showing the preview again. | Flag | Effect | | - | - | | `--ref ` | Switch to a different tag or branch | | `--yes` | Trust the new commit without asking | ```bash theme={null} pan skills pack update mattpocock --ref v1.3.0 ``` Exits 1 on a pack source error, or when the new commit was not trusted. ## pan skills pack list ```bash theme={null} pan skills pack list [--json] [--offline] ``` Lists registered skill packs with their source, cache state, license, skill count, and what is not applied. | Flag | Effect | | - | - | | `--json` | Output as JSON | | `--offline` | Skip the update check (no network) | ```bash theme={null} pan skills pack list ``` ## pan skills pack remove ```bash theme={null} 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. ```bash theme={null} pan skills pack remove gstack ``` 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 ```bash theme={null} pan skills pack sync [id] ``` Re-fetches a pack and extracts its trusted commit, or every registered pack when `id` is omitted. ```bash theme={null} pan skills pack sync gstack ``` Exits 1 if any pack fails to sync. ## pan skills pack gc ```bash theme={null} pan skills pack gc [--max-age-days ] ``` Removes unused skill pack mounts, dangling launch links, stale renders, and orphaned pack state for packs that are no longer registered. | Flag | Effect | | - | - | | `--max-age-days ` | Keep unused mounts younger than this (default: `7`) | ```bash theme={null} pan skills pack gc --max-age-days 14 ``` 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 ```bash theme={null} pan skills pack browser [state] [--yes] ``` Turns a runtime pack's browser runtime on or off (gstack only). `state` defaults to `on`. | Flag | Effect | | - | - | | `--yes` | Trust without asking | ```bash theme={null} pan skills pack browser gstack 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 ```bash theme={null} pan skills pack sageox status [--project ] [--json] ``` Shows, per project, whether the `sageox` pack is on and whether uploads are enabled. | Flag | Effect | | - | - | | `--project ` | Only this project | | `--json` | Output as JSON | ```bash theme={null} pan skills pack sageox status --project myapp ``` Exits 1 if `--project` names a project Overdeck does not know. ## pan skills pack sageox upload ```bash theme={null} pan skills pack sageox upload --project ``` Turns SageOx uploads on or off for a project. Uploads are off by default. | Flag | Effect | | - | - | | `--project ` | Project key (required) | ```bash theme={null} pan skills pack sageox upload on --project myapp ``` Exits 1 if `state` is not `on` or `off`, or on a SageOx config error. ## pan skills deft status ```bash theme={null} pan skills deft status [--project ] [--json] ``` 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). | Flag | Effect | | - | - | | `--project ` | Registered project (default: the current repo) | | `--json` | Output as JSON | ```bash theme={null} pan skills deft status --project myapp ``` Exits 1 if `--project` names a project Overdeck does not know. ## pan skills deft enable ```bash theme={null} pan skills deft enable --project [--yes] ``` Prints the ownership plan for a Directive project and, once accepted, stores the decision to enable managed mode. | Flag | Effect | | - | - | | `--project ` | Registered project (required) | | `--yes` | Accept the printed plan without asking | ```bash theme={null} pan skills deft enable --project myapp --yes ``` 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 ```bash theme={null} pan skills deft disable --project ``` Removes the managed-mode decision for a project. Project files are untouched. | Flag | Effect | | - | - | | `--project ` | Registered project (required) | ```bash theme={null} pan skills deft disable --project myapp ``` Exits 1 if `--project` names a project Overdeck does not know. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.