Salva
3fefae319e
Moved out of ~/Documents/opencode-skills-parked/bin/ (data dir) so the tool has its own versioned home independent of the skill catalog it manages.
49 lines
2.0 KiB
Markdown
49 lines
2.0 KiB
Markdown
# opc-skills
|
|
|
|
Small shell utility for toggling opencode skills between a curated "active" set and a full "parked" catalog. Keeps `~/.config/opencode/skills/` small and intentional while preserving the full skill library offline.
|
|
|
|
This is deliberately a quick, standalone tool — it is **not** a general AI persona manager. For agent / skill / persona management across multiple AI platforms (Claude Code, opencode, Gemini, Paperclip, ...), see the `personas` repo.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
ln -s ~/Documents/opc-skills/bin/opc-skills ~/.local/bin/opc-skills
|
|
```
|
|
|
|
Ensure `~/.local/bin` is on your `PATH`.
|
|
|
|
## Layout it expects
|
|
|
|
```
|
|
~/Documents/opencode-skills-parked/ # full catalog — untracked data dir
|
|
<skill-name>/SKILL.md
|
|
INDEX.json
|
|
INDEX.md
|
|
~/.config/opencode/skills/ # only currently-enabled skills
|
|
<skill-name>/SKILL.md
|
|
```
|
|
|
|
Override via env:
|
|
- `OPC_PARKED` — parked catalog root (default `~/Documents/opencode-skills-parked`)
|
|
- `OPC_ACTIVE` — active skills root (default `~/.config/opencode/skills`)
|
|
|
|
## Commands
|
|
|
|
```
|
|
opc-skills status # counts of active vs parked
|
|
opc-skills list {active|parked|all} # skill folder names
|
|
opc-skills categories # prefix-based category counts
|
|
opc-skills enable <folder> # copy parked → active
|
|
opc-skills disable <folder> # remove from active (parked preserved)
|
|
opc-skills enable-category <prefix> # fzf multi-pick within a prefix
|
|
opc-skills pick # fzf: category → multi-select → enable
|
|
opc-skills search [query] # fzf fuzzy over name+description
|
|
opc-skills reindex # rebuild INDEX.json / INDEX.md
|
|
```
|
|
|
|
`fzf` is required for the interactive commands.
|
|
|
|
## Known interaction
|
|
|
|
The `personas` repo's `build.py --install opencode` currently wipes and repopulates `~/.config/opencode/skills/` as part of installation, which destroys the active set curated here. Use `opc-skills` *after* any personas install, or skip the skills half of `build.py` installs.
|