mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
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.
123 lines
3.6 KiB
Markdown
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
|