Metaplay Docs

Appearance

metaplay skills remove [SKILL] [flags]

[preview] Remove Metaplay skill wrappers from the project (or user home)

metaplay skills remove [SKILL] [flags] ​

PREVIEW: This command is in preview and subject to change!

Delete wrappers previously written by 'metaplay skills install'.

Expected arguments:

  • SKILL (optional) -- Specific skill name to remove (defaults to all metaplay-cli wrappers).

Only files carrying 'managed-by: metaplay-cli' in their frontmatter are removed; user-authored skill files in the same directory are always preserved. After deleting a SKILL.md, the parent skill directory is removed if it is empty.

With no SKILL argument, every metaplay-cli wrapper found under the chosen target dirs is cleaned up — useful for clearing out orphan wrappers from skills that have been removed from the canonical set.

In interactive mode, you'll be prompted for the scope (project or user) and the target dir(s); the default selection is based on which directories already exist.

Examples ​

sh
# Remove all metaplay-cli wrappers from the current project (interactive prompts).
metaplay skills remove
# Remove just one skill.
metaplay skills remove metaplay-develop
# Remove from both standard and Claude Code dirs.
metaplay skills remove --target standard --target claude
# Remove user-scope wrappers under your home directory.
metaplay skills remove --scope user

Flags ​

  • --scope <string>: 'project' (current directory; or --project path) or 'user' (your home directory). Defaults to interactive prompt or 'project'.
  • --target <stringSlice>: Target dir(s). Repeatable. Project scope: standard, claude. User scope: standard, claude, cursor, copilot, codex, windsurf, gemini, junie, continue, cline, warp, goose, amp, opencode, augment, roo. Defaults to interactive prompt or detection. (default: [])

Inherited Flags ​

  • --color <string>: Should the output be colored (yes/no/auto)? [env: METAPLAYCLI_COLOR] (default: auto)
  • --project <string>: Path to the to project directory (where metaplay-project.yaml is located)
  • --skip-version-check: Skip the check for a new CLI version being available
  • --verbose: Enable verbose logging, useful for troubleshooting [env: METAPLAYCLI_VERBOSE]