# 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.