v0.2.0

What this is

skill_management puts a control panel on the skills installed in your OpenCode setup. It can list them, explain why one is unavailable, hide one from the model, and bring it back.

Disabling never touches skill files: it writes a single skill permission rule into your global config (effect: "deny", or "ask" for a soft disable). Nothing is deleted, moved or rewritten, and removing the rule restores the skill exactly as it was.

Action	What it does	Writes config
list	Every registered skill with its effective state for the calling agent (available / disabled / ask)	no
inspect	Why one skill is (un)available: the matching rule, per-agent differences, how its id was derived	no
disable	Hide it from the model and reject loading it (effect: "ask" keeps it listed and asks on load)	yes
enable	Remove the blocking rule again, whoever wrote it	yes

Install in one command: opencode plugin add github:sogeisetsu/opencode-skill-management (details below).

What's changed since v0.1.0

Fixed — list reported the wrong state. It merged every agent's permission rules before evaluating them, so deny rules owned by sub-agents (explorer, title, …) leaked into the caller's result: on a stock setup 28 of 29 skills showed up as disabled while inspect said they were available. States are now evaluated against the calling agent only — the output names that agent, and adds a one-line hint when other agents disagree (which is normal for sub-agents that deny everything).

Added — one-command verification on Linux / WSL. tools/linux-verify.sh puts Node and the OpenCode CLI in a temporary directory under $HOME, runs the full acceptance suite (175 assertions), confirms a real OpenCode host loads the plugin, then cleans up after itself. No sudo, no writes to your real config.

Docs — README rewritten for users. It now leads with the problem the tool solves and explains the four actions (list / inspect / disable / enable): what each one does, when to reach for it, and whether it writes configuration.

Verified. 175 assertions pass on Windows and on Linux (Debian 13.5, OpenCode 2.0.32). The disable → rejected load → enable round trip was re-run on a Linux host: the skill disappears from the model-visible list, loading it is rejected, and enable restores it.

Install or upgrade

# via git (no registry, no token)
opencode plugin add github:sogeisetsu/opencode-skill-management

# via npm
opencode plugin add opencode-skill-management@0.2.0

Offline / single file: download skill_management.js from the assets below and drop it into <config>/plugins/. The opencode-skill-management-0.2.0.tgz asset is the exact npm tarball if you prefer to unpack it yourself.

Confirm it is loaded:

opencode plugin list --builtin
# skill_management   local   <config>/plugins/skill_management.js

Full changelog: v0.1.0...v0.2.0