uninstall

从 source 目录中移除一个或多个 skills 或 tracked repositories。Skills 会被移动到 trash，保留 7 天后自动清理。

skillshare uninstall my-skill              # Remove a single skill
skillshare uninstall a b c --force         # Remove multiple skills at once
skillshare uninstall --all                 # Remove all skills
skillshare uninstall --group frontend      # Remove all skills in a group
skillshare uninstall team-repo             # Remove tracked repository (_ prefix optional)

何时使用

移除不再需要的 skills（它们会移动到 trash，保留 7 天）
清理不再使用的 tracked repository
一次性批量移除整个 group 的 skills
使用 --all 一次性移除所有 skills

$ skillshare uninstall css-review
  frontend/css-review  ~/.config/skillshare/skills/frontend/css-review · 1 file
✓ Uninstall frontend/css-review → trash, kept 7 days

Next
  skillshare sync                               remove it from claude, cursor
  skillshare trash restore frontend/css-review  undo

会发生什么

选项

Flag	Description
`--all`	Remove all skills from source (requires confirmation)
`--group, -G <name>`	Remove all skills in a group (prefix match, repeatable)
`--force, -f`	Skip confirmation and ignore uncommitted changes
`--dry-run, -n`	Preview without making changes
`--project, -p`	Use project-level config in current directory
`--global, -g`	Use global config (`~/.config/skillshare`)
`--json`	Global mode: output JSON and skip confirmation; dirty tracked repositories still require `--force`
`--help, -h`	Show help

JSON 输出

skillshare uninstall my-skill another-skill --json

{
  "removed": ["my-skill", "another-skill"],
  "failed": [],
  "skipped": 0,
  "dry_run": false,
  "duration": "0.089s"
}

结合 --dry-run 进行预览：

skillshare uninstall --all --json --dry-run

移除多个

一条命令移除多个 skills：

skillshare uninstall alpha beta gamma --force

当某些 skills 找不到时，该命令会跳过它们并给出警告，然后继续移除其余的。只有当所有指定的 skills 都无效时才会失败。

Glob 模式

Skill 名称支持 glob 模式（*、?、[...]）用于批量移除：

skillshare uninstall "core-*"              # Remove all skills matching core-*
skillshare uninstall "test-?" --force      # Single-character wildcard
skillshare uninstall "core-*" "util-*"     # Multiple patterns

Glob 匹配不区分大小写："Core-*" 会匹配 core-auth、CORE-DB 等。

Top-level matching only

Glob 模式只匹配 source 文件夹中的顶层目录名。嵌套的 skills（例如 frontend/react-hooks）不会被 "react-*" 匹配到——请使用 --group frontend 来定位某个子目录中的 skills。

--group 会拒绝像 _dev-skills 这样被跟随的 source link，因为它会把真实 checkout 中的所有 skills 都移走。移除链接条目请用 skillshare unlink _dev-skills，或按名称指定 skills（skillshare uninstall _dev-skills/foo）把它们从 checkout 移到 trash。

如果链接文件夹的根目录包含 SKILL.md，uninstall 会拒绝移除该根级 skill，因为移动它会移除链接，让所有嵌套 skills 也从列表中消失。请用 unlink 只移除链接，checkout 保持不变。

移除全部

使用 --all 一次性从 source 目录中移除所有 skills：

skillshare uninstall --all                 # Interactive confirmation
skillshare uninstall --all --force         # Skip confirmation
skillshare uninstall --all -n              # Preview what would be removed

--all 不能与 skill 名称或 --group 组合使用。

Shell glob 保护

不带引号运行 skillshare uninstall * 会导致你的 shell 将 * 展开为当前目录中的文件名。 skillshare 会检测到这一点，并建议改用 --all。请始终为通配符加上引号（"*"）或使用 --all。

Group 移除

当你 uninstall 一个包含子 skills 的目录时，skillshare 会自动将其检测为一个 group，并在请求确认之前列出其中包含的 skills：

Uninstalling group (5 skills)
─────────────────────────────────────────
  - feature-radar
  - feature-radar-archive
  - feature-radar-learn
  - feature-radar-ref
  - feature-radar-scan
→ Name: feature-radar
→ Path: ~/.config/skillshare/skills/feature-radar

? Uninstall group feature-radar? moved to trash for 7 days   Yes   No

--group flag 使用前缀匹配移除某个目录下的所有 skills：

# Remove all skills under frontend/
skillshare uninstall --group frontend

# Also removes nested skills: frontend/react/hooks, frontend/vue/composables
skillshare uninstall --group frontend --force

# Preview what would be removed
skillshare uninstall --group frontend --dry-run

当执行 group 移除（包括自动检测到的目录 group）时，每个被移除的成员也会从配置中受管理的 skills: 列表中移除（~/.config/skillshare/config.yaml，或 project mode 下的 .skillshare/config.yaml）。

你可以将位置参数名称与 --group 组合使用，甚至可以多次使用 -G：

# Mix names and groups
skillshare uninstall standalone-skill -G frontend -G backend --force

# Duplicates are automatically deduplicated
skillshare uninstall frontend/hooks -G frontend --force  # hooks removed once

Tracked Repositories

对于 tracked repositories（以 _ 开头的文件夹）：

检查是否有未提交的更改（使用 --force 覆盖）
当 skillshare 无法读取该仓库的 git status 时，以 failed to check git status 失败；批次中的其他项目仍会被移除，--force 会跳过此检查
自动从 .gitignore 中移除该条目
Uninstall 时 _ 前缀是可选的

skillshare uninstall _team-skills        # With prefix
skillshare uninstall team-skills         # Without prefix (auto-detected)
skillshare uninstall _team-skills --force # Force remove with uncommitted changes

示例

# Remove a single skill
skillshare uninstall my-skill

# Remove multiple skills
skillshare uninstall skill-a skill-b skill-c --force

# Remove all skills
skillshare uninstall --all
skillshare uninstall --all --force
skillshare uninstall --all -n              # Preview

# Remove by group
skillshare uninstall --group frontend --force

# Preview removal
skillshare uninstall my-skill --dry-run
skillshare uninstall --group frontend -n

# Remove tracked repository
skillshare uninstall team-repo

# Mix names and groups
skillshare uninstall my-skill -G frontend --force

安全性

被 uninstall 的 skills 会被移动到 trash，而不是永久删除：

位置：~/.local/share/skillshare/trash/（global）或 .skillshare/trash/（project）
**保留期：**7 天，之后自动清理
**重新安装提示：**如果该 skill 是从远程来源安装的，会显示重新安装命令
**恢复：**使用 skillshare trash restore <name> 从 trash 恢复

单个 skill（详细模式）：

  my-skill  ~/.config/skillshare/skills/my-skill · 2 files
✓ Uninstall my-skill → trash, kept 7 days

Next
  skillshare sync                                   remove it from claude, cursor
  skillshare trash restore my-skill                 undo
  skillshare install github.com/user/repo/my-skill  reinstall it later

多个 skills（批量）：

Failed
✗ bad-skill  failed to move to trash: ...

Removed
✓ pdf       skill
✓ tdd       skill
✓ security  group, 2 skills

! Uninstalled 3, 1 failed · 0.1s

Next
  skillshare sync        remove them from claude, cursor
  skillshare trash list  restore any of them within 7 days

大批量操作会使用精简格式：

Failed
✗ bad-a     failed to move to trash: permission denied
✗ bad-b     failed to move to trash: permission denied

Removed
✓ 920 uninstalled

! Uninstalled 920, 2 failed · 1.2s

Next
  skillshare sync        remove them from claude, cursor
  skillshare trash list  restore any of them within 7 days

要恢复一个不小心 uninstall 的 skill：

skillshare trash list                  # See what's in trash
skillshare trash restore my-skill      # Restore to source
skillshare sync                        # Sync back to targets

Uninstall 之后

运行 skillshare sync 从所有 targets 中移除该 skill：

skillshare uninstall old-skill
skillshare sync  # Remove from Claude, Pi, etc.

Project Mode

从项目的 .skillshare/skills/ 中 uninstall skills 或 tracked repos：

skillshare uninstall my-skill -p                  # Remove a skill
skillshare uninstall a b c -p -f                  # Remove multiple skills
skillshare uninstall --all -p -f                   # Remove all project skills
skillshare uninstall --group frontend -p -f        # Remove a group
skillshare uninstall team-skills -p                # Tracked repo (_ prefix optional)

在 project mode 下，uninstall 会：

将 skill 目录移动到 .skillshare/trash/（保留 7 天）
从 .skillshare/config.yaml 的 skills: 列表中移除该 skill 的条目（对于远程 skills）
从 .skillshare/.gitignore 中移除该条目（对于远程/tracked skills）
从 .skillshare/skills.lock.json 中移除该 skill 的固定（对于 group，则移除其下的所有固定）
对于 tracked repos：检查是否有未提交的更改，并在无法读取 git status 时失败（使用 --force 可同时覆盖两者）
_ 前缀是可选的——会自动检测

skillshare uninstall pdf -p
skillshare sync
git add .skillshare/ && git commit -m "Remove pdf skill"

Agent 支持

使用 --kind agent 来 uninstall agents 而非 skills：

skillshare uninstall --kind agent tutor              # Remove an agent
skillshare uninstall --kind agent tutor reviewer -f   # Remove multiple agents
skillshare uninstall --kind agent --all               # Remove all agents

Agent uninstall 遵循与 skills 相同的移入 trash 并保留的行为（移动到 trash，保留 7 天）。背景信息参见 Agents。

另请参阅

install — 安装 skills
list — 列出已安装的 skills
trash — 管理已删除到 trash 的 skills
Project Skills — Project mode 概念
Agents — Agent 概念

何时使用​

会发生什么​

选项​

JSON 输出​

移除多个​

Glob 模式​

移除全部​

Group 移除​

Tracked Repositories​

示例​

安全性​

Uninstall 之后​

Project Mode​

Agent 支持​

另请参阅​