Expand description
Persistent enable/disable state shared by runtime/API Skill catalogs.
Backs GET /v1/skills (enabled field per skill) and
POST /v1/skills/{name} (toggle). Discovery tells us which Skills exist;
this store is the final exact-name activation filter shared by prompts,
tools, TUI surfaces, sub-agents, and the API. Plugin trust/enablement stays
a separate bundle lifecycle gate.
Storage shape (TOML at ~/.codewhale/skills_state.toml, legacy ~/.deepseek/skills_state.toml):
disabled = ["skill-name-1", "skill-name-2"]Reserved !codewhale-skill-state:1:* entries retain legacy vetoes and
exact enables in that same set. The leading ! cannot be a discovered
skill name. v0.10.0 writers preserve these strings, unlike unknown TOML
fields. This preserves new-reader policy through their serialization;
it does not make old readers understand distinct Unicode identities or
old lossy/no-op toggles express the new per-skill choices. Upgrade all
runtimes sharing this directory for consistent activation controls.
Default state when the file does not exist: empty list (everything enabled). A present but unreadable or malformed file is an error. Callers may keep native Skills available for recovery, but reviewed plugin Skills must stay hidden until their exact activation state can be read authoritatively.