zcode-configuration-guidelisted

Use when configuring ZCode's extension resources (MCP servers, slash commands, skills, hooks, and plugins) or instruction files such as AGENTS.md in the ZCode client. Explains where each resource is configured at the user and workspace scope, the discovery order, precedence, and merge rules, plus guidance on which location to choose. Use when someone asks how to add an MCP server, command, skill, hook, plugin, or AGENTS.md instructions, where a configuration file lives, why a configuration is not taking effect, or needs routing to a specific diagnostic skill.
phoben/agent-skills · ★ 0 · Code & Development · score 70

Install: claude install-skill phoben/agent-skills

# ZCode Configuration Guide ZCode supports five types of extension resources, plus AGENTS.md instruction files. This skill is the **map**: it tells you where each resource is configured and how conflicts are resolved. For "something is not working, how do I fix it," follow the routing to the `diagnosing-*` skills at the end. ## How things are configured There are two ways to work with configuration in the ZCode client, and this plugin serves both: - **A person** manages resources through the client's graphical interface — **Settings → Plugin Management**, **Settings → Skills**, **Settings → Subagents**, **Settings → MCP**, and the **`/` menu** in the input box. - **An agent** repairs configuration by reading and editing the underlying files directly with its file tools. The locations and rules below are what an agent uses to find the right file and field. ## Scopes and the main configuration files - **User scope** — lives under your home directory and applies to every workspace. - **Workspace scope** — lives inside a repository and applies only to that project; can be shared with a team through version control. - **User configuration file**: `~/.zcode/cli/config.json`. Holds MCP servers, hooks, plugin enable/disable state, and skill/command disable overrides. - **Workspace configuration file**: `<repo>/.zcode/config.json` (or `<repo>/zcode.json`). - **User instruction file**: `~/.zcode/AGENTS.md`. Applies as default instructions for every workspace. - **Workspace instru