Files
skillshare/website/docs/reference/commands/enable.md
T
Willie 58a78ab131 docs: add v0.18.3 changelog, enable/disable docs, and release notes
- New enable/disable command reference page with examples and Mermaid diagrams
- Update command index, list, upgrade, and filtering docs for new features
- Add enable page to sidebar under Skill Management
- Update SKILL.md with enable/disable recipes and version bump to v0.18.3
- Sync changelog to website, update README latest note
- Document upgrade auto-sudo, TUI E key toggle, and [disabled] label
2026-03-29 04:59:23 +08:00

2.9 KiB

sidebar_position
sidebar_position
5

enable / disable

Temporarily enable or disable skills without removing them.

skillshare disable draft-*          # Disable by pattern
skillshare enable draft-*           # Re-enable
skillshare disable my-skill -p      # Project mode

When to Use

  • Temporarily hide a skill from sync without uninstalling it
  • Mute a draft or experimental skill across all targets
  • Toggle skills on/off from the list TUI with the E key

How It Works

disable adds a pattern to .skillignore; enable removes it. Disabled skills stay in the source directory but are excluded from sync and collect.

flowchart LR
    DIS["skillshare disable my-skill"]
    IGN[".skillignore += my-skill"]
    SYNC["sync skips my-skill"]
    DIS --> IGN --> SYNC
flowchart LR
    EN["skillshare enable my-skill"]
    IGN[".skillignore -= my-skill"]
    SYNC["sync includes my-skill"]
    EN --> IGN --> SYNC

:::tip After enabling or disabling, run skillshare sync to apply the change to targets. :::

Options

Flag Description
<name|pattern> One or more skill names or patterns (e.g., draft-*)
--project, -p Use project .skillignore (.skillshare/skills/.skillignore)
--global, -g Use global .skillignore (~/.config/skillshare/.skillignore)
--dry-run, -n Preview without writing
--help, -h Show help

Mode is auto-detected when neither -p nor -g is specified (same as other commands).

Examples

# Disable a single skill
$ skillshare disable my-draft
Disabled: my-draft (added to .skillignore)
Run 'skillshare sync' to apply changes.

# Disable by glob pattern
$ skillshare disable "experimental-*"
Disabled: experimental-* (added to .skillignore)
Run 'skillshare sync' to apply changes.

# Re-enable
$ skillshare enable my-draft
Enabled: my-draft (removed from .skillignore)
Run 'skillshare sync' to apply changes.

# Preview without writing
$ skillshare disable my-skill --dry-run
Would add 'my-skill' to ~/.config/skillshare/skills/.skillignore

# Already disabled
$ skillshare disable my-draft
warning: my-draft is already disabled

TUI Toggle

In the interactive skillshare list TUI, press E to toggle the selected skill's enabled/disabled state. The change is written to .skillignore immediately — no need to exit the TUI first.

Disabled skills show a red disabled badge in the detail panel.

Where is the .skillignore?

Mode Path
Global ~/.config/skillshare/skills/.skillignore
Project .skillshare/skills/.skillignore

The file is created automatically on first disable.

See Also