platforms — Manage configured platforms

List or reset all configured AI coding platforms.

platforms list

List all configured platforms. By default only enabled platforms (enabled: true) are shown, sorted by display name; the NAME column shows the display name (falls back to the config key when absent):

xskill platforms list

The bare xskill platforms command is equivalent to xskill platforms list.

Output format (columns NAME, PATH, SKILLS, AGENTS, SOURCE, COMPAT, ENABLED):

NAME         PATH     SKILLS  AGENTS      SOURCE     COMPAT  ENABLED
Claude Code  .claude  skills  CLAUDE.md   AGENTS.md  ✗       ✓
Codex        .codex   skills  AGENTS.md   AGENTS.md  ✓       ✓
Cline        .cline   skills  CLAUDE.md   AGENTS.md  ✓       ✗

✓ in green indicates compatibility/enabled (agents_compat: true / enabled: true), ✗ in red indicates incompatibility/disabled.

Show all platforms, including disabled ones (columns NAME, PATH, SKILLS, AGENTS, SOURCE, COMPAT, ENABLED):

xskill platforms list -a

The output format is the same as the default view, with disabled platforms marked by ✗ in the ENABLED column:

NAME         PATH     SKILLS  AGENTS      SOURCE     COMPAT  ENABLED
Claude Code  .claude  skills  CLAUDE.md   AGENTS.md  ✗       ✓
Codex        .codex   skills  AGENTS.md   AGENTS.md  ✓       ✓
Cline        .cline   skills  CLAUDE.md   AGENTS.md  ✓       ✗

Options:

  • -a, --all — Show all platforms, including disabled ones, marked by the ENABLED column

All views output the full column set (NAME, PATH, SKILLS, AGENTS, SOURCE, COMPAT, ENABLED).

Compatible platforms (agents_compat: true) are pre-selected in the interactive target-platform picker used by add, link, and related commands.

platforms reset

Reset platforms to the built-in default platform list. The mode is selected via mutually exclusive flags (non-interactive, no TUI):

  • --replace (short -r) — Full restore: reset all platforms to built-in defaults, dropping custom platforms
  • --merge (short -m) — Careful merge: restore built-in platforms to defaults, keeping custom platforms

Exactly one flag is required: providing both reports an error and performs no reset; providing neither prints the usage help (exit code 0, config untouched).

If custom platforms exist, a prompt is printed first. Other configuration fields (sources, cache, proxy, etc.) are not affected.

Example:

$ xskill platforms reset --replace
Custom platforms: my-custom
Platforms reset: 18 platforms, replaced with defaults (custom dropped)

Edge cases:

  • “No platforms configured” is printed when no platforms are configured.
  • Empty fields are displayed as -.