mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-18 18:04:17 +00:00
Surface the existing .skillignore glob support in the enable/disable command reference and the folder-organization guide. Users reported (issue #209) only finding it buried in reference/filtering, assuming disable accepted skill names only. Add "frontend/**" folder examples, a dedicated "Disable a Whole Folder" section, and shell-quoting guidance.
146 lines
4.8 KiB
Markdown
146 lines
4.8 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 "frontend/**" # Disable every skill in a folder
|
|
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 glob patterns (e.g., `draft-*`, `frontend/**`) |
|
|
| `--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
|
|
```
|
|
|
|
## Disable a Whole Folder
|
|
|
|
`disable`/`enable` accept the same glob syntax as `.skillignore`, so there is no separate "group" flag — point a pattern at the folder and every skill inside is toggled at once.
|
|
|
|
```bash
|
|
# Disable every skill under frontend/ (any depth)
|
|
$ skillshare disable "frontend/**"
|
|
Disabled: frontend/** (added to .skillignore)
|
|
Run 'skillshare sync' to apply changes.
|
|
|
|
# Re-enable the whole folder
|
|
$ skillshare enable "frontend/**"
|
|
Enabled: frontend/** (removed from .skillignore)
|
|
Run 'skillshare sync' to apply changes.
|
|
```
|
|
|
|
:::tip Quote the pattern
|
|
Always wrap folder patterns in quotes (`"frontend/**"`) so your shell doesn't expand `*` before skillshare sees it.
|
|
:::
|
|
|
|
`frontend/**` writes a single line to `.skillignore` and keeps covering anything you add to the folder later. `enable` with the **same** pattern removes that line. To disable individual skills instead, list them by name (`skillshare disable a b c`). See [.skillignore pattern syntax](/docs/reference/filtering#skillignore) for the full glob reference (`*`, `**`, `?`, `[abc]`, `!negation`, anchored `/`, directory-only `pattern/`).
|
|
|
|
## 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
|