Files
skillshare/website/docs/reference/commands/uninstall.md
T
Willie bbb3f04f27 docs: sync command docs for 0.25.2
The 0.25.2 fixes changed behavior the command pages still described
the old way: update said any .git/ directory makes a tracked repo, the
uninstall Project Mode section missed --into repos and the refusal
inside a tracked repo, and the audit rule table lacked
prompt-injection-5. Also translate the uninstall example comments that
were left in English in ja, ko, zh-Hans and zh-Hant.
2026-10-08 01:34:36 +08:00

12 KiB

sidebar_position
sidebar_position
3

uninstall

Remove one or more skills or tracked repositories from the source directory. Skills are moved to trash and kept for 7 days before automatic cleanup.

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)

When to Use

  • Remove skills you no longer need (they move to trash for 7 days)
  • Clean up a tracked repository you've stopped using
  • Batch-remove an entire group of skills at once
  • Remove all skills at once with --all
$ 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

What Happens

flowchart TD
    TITLE["skillshare uninstall"]
    S1["1. Resolve targets"]
    S2["2. Pre-flight checks"]
    S3["3. Confirm and move to trash"]
    TITLE --> S1 --> S2 --> S3

Options

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 Output

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

Combine with --dry-run to preview:

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

Multiple Skills

Remove several skills in one command:

skillshare uninstall alpha beta gamma --force

When some skills are not found, the command skips them with a warning and continues removing the rest. It only fails if all specified skills are invalid.

Glob Patterns

Skill names support glob patterns (*, ?, [...]) for batch removal:

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

Glob matching is case-insensitive: "Core-*" matches core-auth, CORE-DB, etc.

:::note Top-level matching only Glob patterns match against top-level directory names in the source folder. Nested skills (e.g. frontend/react-hooks) are not matched by "react-*" — use --group frontend to target skills within a subdirectory. :::

--group refuses a followed source link such as _dev-skills, because it would move every skill out of the real checkout. Use skillshare unlink _dev-skills to remove the link entry, or name the skills (skillshare uninstall _dev-skills/foo) to trash them from the checkout.

If the linked folder itself contains SKILL.md, uninstall refuses that root skill: moving it would remove the link and hide all nested skills. Use unlink to remove only the link; the checkout stays untouched.

Remove All

Use --all to remove every skill from the source directory at once:

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

--all cannot be combined with skill names or --group.

:::tip Shell glob protection Running skillshare uninstall * without quotes causes your shell to expand * into file names in the current directory. skillshare detects this and suggests using --all instead. Always quote the wildcard ("*") or use --all. :::

Group Removal

When you uninstall a directory that contains sub-skills, skillshare automatically detects it as a group and lists the contained skills before asking for confirmation:

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

The --group flag removes all skills under a directory using prefix matching:

# 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

When group removal is applied (including auto-detected directory groups), each removed member is also removed from the managed skills: list in config (~/.config/skillshare/config.yaml or .skillshare/config.yaml in project mode).

You can combine positional names with --group, and even use -G multiple times:

# 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

For tracked repositories (folders starting with _):

  • Checks for uncommitted changes (use --force to override)
  • Fails with failed to check git status when skillshare cannot read the repo's git status; other items in the batch are still removed, and --force skips the check
  • Automatically removes the entry from .gitignore
  • The _ prefix is optional when uninstalling
  • A repo installed with --into is named by its path, such as devops/_team-skills
  • For --into repos, the final _ is optional too: devops/team-skills resolves to devops/_team-skills. An existing skill or folder at the typed path takes precedence; use the explicit _ path to remove the repo. Ambiguous short names fail and require the full path.
  • A skill or folder inside a tracked repo cannot be removed on its own, even with --force; the command fails with inside a tracked repo; uninstall the repo instead. Skills below a followed source link can still be removed one at a time
skillshare uninstall _team-skills        # With prefix
skillshare uninstall team-skills         # Without prefix (auto-detected)
skillshare uninstall _team-skills --force # Force remove with uncommitted changes
skillshare uninstall devops/_team-skills # Repo installed with --into devops
skillshare uninstall devops/team-skills  # Same repo, unless this path already exists

Examples

# 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

Safety

Uninstalled skills are moved to trash, not permanently deleted:

  • Location: ~/.local/share/skillshare/trash/ (global) or .skillshare/trash/ (project)
  • Retention: 7 days, then automatically cleaned up
  • Reinstall hint: If the skill was installed from a remote source, the reinstall command is shown
  • Restore: Use skillshare trash restore <name> to recover from trash

Single skill (verbose):

  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

Multiple skills (batch):

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

Large batches use a condensed format:

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

To restore an accidentally uninstalled skill:

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

After Uninstalling

Run skillshare sync to remove the skill from all targets:

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

Project Mode

Uninstall skills or tracked repos from the project's .skillshare/skills/:

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)

In project mode, uninstall:

  • Moves the skill directory to .skillshare/trash/ (kept 7 days)
  • Removes the skill's entry from .skillshare/config.yaml skills: list (for remote skills)
  • Removes the entry from .skillshare/.gitignore (for remote/tracked skills)
  • Removes the skill's pin from .skillshare/skills.lock.json (for a group, every pin under it)
  • For tracked repos: checks for uncommitted changes, and fails when the git status cannot be read (use --force to override both)
  • The _ prefix is optional — auto-detected
  • Repos installed with --into work as in global mode: devops/team-skills -p resolves to devops/_team-skills, and a skill or folder inside a tracked repo cannot be removed on its own
skillshare uninstall pdf -p
skillshare sync
git add .skillshare/ && git commit -m "Remove pdf skill"

Agent Support

Use --kind agent to uninstall agents instead of 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 follows the same trash-and-retain behavior as skills (moved to trash, kept 7 days). See Agents for background.

See Also