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:

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

2. Prefer JSON for machine parsing:

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:

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

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

Install

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:

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

Install from ClawHub:

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

Install from plugin markets:

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:

smp --json skills list
smp --json presets current

Update And Check

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:

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

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:

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:

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:

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:

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

WebDAV sync:

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:

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.