Identify the failing layer
- Files: verify the plugin directory and entry point.
- Registration: validate the marketplace manifest and plugin entry.
- Enablement: check both plugin and individual skill toggles.
- Runtime: restart the app and make a read-only tool call.
RiskBack up the relevant configuration before deleting any cache. A broad reset can remove unrelated plugin state.
Investigation order
- Record whether the plugin is missing or installed but unloaded.
- Validate the manifest as UTF-8 JSON without a byte order mark where possible.
- Confirm all required skills are enabled.
- Fully restart Codex so it reloads the manifest.
- Verify one real, read-only tool result. A visible list entry alone is not enough.
Success checks
- The plugin appears and is enabled.
- Its tools are visible.
- A real read-only call succeeds after restart.