Skip to main content

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.

tip

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

Options​

FlagDescription
<name|pattern>One or more skill names or patterns (e.g., draft-*)
--project, -pUse project .skillignore (.skillshare/skills/.skillignore)
--global, -gUse global .skillignore (~/.config/skillshare/.skillignore)
--dry-run, -nPreview without writing
--help, -hShow 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?​

ModePath
Global~/.config/skillshare/skills/.skillignore
Project.skillshare/skills/.skillignore

The file is created automatically on first disable.

Agent Support​

Use --kind agent to enable or disable agents. This writes to .agentignore instead of .skillignore:

skillshare disable --kind agent draft-reviewer     # Disable an agent
skillshare enable --kind agent draft-reviewer      # Re-enable an agent
skillshare disable --kind agent "experimental-*"   # Disable by pattern
Mode.agentignore path
Global~/.config/skillshare/agents/.agentignore
Project.skillshare/agents/.agentignore

See Agents for background on agent management.

See Also​