Files
skillshare/website/docs/reference/commands/enable.md
T
Willie d759a7e8ee docs: add agent support to all command reference and getting-started pages
Command pages updated (7 files):
- list: 'skillshare list agents', [A] badge
- install: --kind agent, -a flag, auto-detection
- sync: agent sync with all three modes, supported targets
- check: 'skillshare check agents' drift detection
- audit: 'skillshare audit agents'
- enable: --kind agent routes to .agentignore
- uninstall: --kind agent flag

Getting started updated:
- first-sync: link to agents concepts in What's Next
- quick-reference: agent management command table + agents source path

Commands index: added agents row to What do you want to do table.
2026-04-07 18:05:40 +08:00

3.6 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.

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