initial: opc-skills standalone tool

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.

README.md

@@ -0,0 +1,48 @@
+# 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.