Manage Skills

---
name: manage-skills
description: Manage the user's Skills-Manager-Plus skill library through smp: install, update, remove, enable or disable, sync, search, adopt local skills, manage presets, inspect workspaces, and operate plugin, ClawHub, Git backup, WebDAV, and data backup workflows. Use this whenever the user wants to install, find, update, remove, list, sync, import, adopt, or back up skills through Skills-Manager-Plus instead of writing directly into one agent's skills directory.
---

# Manage Skills With Skills-Manager-Plus

Use this skill when the user asks to manage agent skills and `smp` is available.

## Before Acting

1. Check the CLI exists:

```bash
command -v smp || command -v skills-manager-plus-cli
```

2. Prefer JSON for machine parsing:

```bash
smp --json skills list
```

3. If the CLI is not available, say that Skills-Manager-Plus CLI is not on `PATH` and fall back to direct repository or filesystem inspection only when that is safe.

## Mental Model

Skills-Manager-Plus maintains one central library under `~/.skills-manager-plus/skills/` by default. Metadata, source refs, tags, presets, plugin metadata, and sync state live in the app database. A preset is a named skill set. Applying a preset syncs its skills to enabled agents such as Claude Code, Cursor, Codex, Gemini CLI, Windsurf, OpenClaw, and custom agents by symlink or copy.

The normal lifecycle is:

```text
install -> central library -> add to preset -> sync -> visible to selected agents
```

Use `--sync` when the user expects the skill to be usable immediately.

## Install

```bash
smp skills install ./my-skill --local --sync
smp skills install https://github.com/user/repo.git --git --sync
smp skills install https://github.com/user/repo/tree/main/skills/foo --git --sync-preset "Default"
```

Search and install from skills.sh:

```bash
smp --json skills search "react performance" --limit 5
smp skills install owner/repo/skill --skillssh --sync
```

Install from ClawHub:

```bash
smp clawhub search obsidian --limit 10
smp clawhub detail openclaw/example
smp clawhub install openclaw/example
```

Install from plugin markets:

```bash
smp plugins markets
smp plugins add-market https://github.com/user/plugin-market.git
smp plugins refresh <market-id>
smp plugins list
smp plugins install <market-id> <plugin-name>
```

Always verify after install:

```bash
smp --json skills list
smp --json presets current
```

## Update And Check

```bash
smp skills check --all
smp skills update <skill-name-or-id>
smp skills update --all
```

`check` probes remote revisions without rewriting files. `update` refreshes eligible Git, skills.sh, ClawHub, plugin-backed, and local/imported sources according to their recorded metadata.

## Remove, Enable, Disable

Preview destructive operations first:

```bash
smp skills remove <skill> --dry-run
smp skills remove <skill> --yes
smp skills disable <skill>
smp skills enable <skill>
```

Removing deletes the central copy, database row, and managed synced targets. Disabling keeps the skill in the library but excludes it from future preset syncs.

## Presets And Sync

```bash
smp presets list
smp presets current
smp presets apply "Default"
smp presets add-skill "Default" rss-ai-digest
smp presets remove-skill "Default" rss-ai-digest
smp skills sync
smp skills sync --preset "Default"
smp skills sync --tool codex
```

Use a preset command when changing intended membership. Use `skills sync` when the target directories need to be reconciled with the current preset.

## Adopt Local Agent Skills

When a skill already exists in an agent directory but is not in the central library:

```bash
smp local scan
smp skills adopt ~/.agents/skills --dry-run
smp skills adopt ~/.agents/skills
```

If the skill should remain updateable from Git, install it from its Git URL instead of adopting it as a plain local source.

## Global And Project Workspaces

Inspect and manage global agent directories:

```bash
smp workspace agents
smp workspace skills codex
smp workspace document codex rss-ai-digest
smp workspace add codex rss-ai-digest
smp workspace remove codex rss-ai-digest
smp workspace import codex local-only-skill
smp workspace pull codex rss-ai-digest
```

For project-local skills, use the desktop app when possible because project selection and multi-agent target review are easier visually. Use CLI only when the desired target is explicit.

## Backup And Recovery

Git-backed central skills backup:

```bash
smp git status
smp git init
smp git set-remote https://github.com/user/skills-backup.git
smp git pull
smp git commit -m "backup: sync skills library"
smp git push
smp git versions --limit 10
smp git restore sm-v-20260522-120000
```

Database backup:

```bash
smp backup create
smp backup list
smp backup export /tmp/skills-manager-plus.sql
smp backup import /tmp/skills-manager-plus.sql
```

WebDAV sync:

```bash
smp webdav settings
smp webdav test
smp webdav upload
smp webdav remote-info
smp webdav download
```

## External Roots

Use `--skills-root` for temporary smoke tests or when operating on a cloned/exported skills repo without touching the default app repository:

```bash
smp --skills-root /tmp/smp-smoke --json repo status
smp --skills-root /tmp/smp-smoke --json skills list
```

Do not point `--skills-root` at another app's live repository unless the user explicitly asks for that migration.