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

123 lines
3.6 KiB
Markdown

---
sidebar_position: 5
---
# enable / disable
Temporarily enable or disable skills without removing them.
```bash
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`.
```mermaid
flowchart LR
DIS["skillshare disable my-skill"]
IGN[".skillignore += my-skill"]
SYNC["sync skips my-skill"]
DIS --> IGN --> SYNC
```
```mermaid
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
```bash
# 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`:
```bash
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](/docs/understand/agents) for background on agent management.
## See Also
- [list](./list.md) — View disabled skills and toggle with `E` key
- [Filtering Skills](/docs/how-to/daily-tasks/filtering-skills) — All filtering layers
- [.skillignore](/docs/reference/filtering#skillignore) — Pattern syntax
- [sync](./sync.md) — Apply changes after enable/disable
- [Agents](/docs/understand/agents) — Agent concepts