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.
2.0 KiB
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
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.