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.