ZCode Handbook

The missing developer handbook for ZCode.

Master ZCode skills, agents, MCP servers, subagents, Goal Mode, Remote Control and troubleshooting — directly inside your coding workflow.

7 Skills · 2 Slash Commands · Automatic Skill Discovery · English Handbook

---

Why ZCode Handbook?

ZCode is powerful, but its features are spread across agents, skills, plugins, MCP servers, subagents, Goal Mode and remote workflows.

This plugin brings the most important ZCode knowledge directly into your assistant, so you can stop switching between documentation pages and your editor.

Use it to:

• Learn how ZCode skills work
• Build better custom skills
• Understand agents, execution modes and AGENTS.md
• Configure MCP servers and plugins
• Use Goal Mode and Task Management effectively
• Work with Remote Control and Bot Channel
• Troubleshoot common ZCode problems faster

---

What’s Included?

Area	Description
Agent Workflow	Agents, execution modes, AGENTS.md, workflow patterns
Skill System	Skill anatomy, progressive disclosure, discovery and best practices
Goal Mode	Goal Mode, task management, file management and edit history
Remote Control	Remote Control and Bot Channel usage
Subagents	General-purpose, Explore and custom subagents
MCP & Plugins	MCP servers, plugin structure and commands
Best Practices	Diagnostics, troubleshooting and production usage tips

---

Plugin Contents

Plugin	Language	Skills	Commands
zcode-handbook-en	English	7	2

Skills

Skill	Coverage
zcode-agent-en	Agent, execution modes, AGENTS.md, workflow
zcode-skill-guide	Skill anatomy, progressive disclosure, discovery, creation and best practices
zcode-goal-task-en	Goal Mode, Task & File Management, Edit History
zcode-remote-en	Remote Control, Bot Channel
zcode-subagents-en	Subagents: general-purpose, Explore and custom
zcode-mcp-plugin-en	MCP Servers, Plugin, Commands
zcode-best-practices-en	Best practices and diagnostics

---

Installation

Option 1: Add as a ZCode Marketplace Source

1. Open ZCode
2. Go to Settings
3. Open Plugin Management
4. Go to the Marketplace tab
5. Click the + button
6. Add this repository:

imserhatdemir/zcode-handbook-plugin

or use the Git URL:

[https://github.com/imserhatdemir/zcode-handbook-plugin.git](https://github.com/imserhatdemir/zcode-powerpack.git)

7. Click Add
8. Find the plugin in the Discover list
9. Click Get to install it

---

Option 2: Local Installation

Clone the repository:

git clone https://github.com/imserhatdemir/zcode-handbook-plugin.git

Then add the local repository path from:

Settings → Plugin Management → Marketplace → +

---

Usage

After installation, ZCode can automatically discover and load the relevant skill based on your question.

Slash Commands

/handbook

Shows an overview of the ZCode Handbook and available topics.

/troubleshoot

Helps diagnose common ZCode setup, workflow and plugin issues.

---

Manual Skill Invocation

You can also invoke a specific skill manually:

$zcode-skill-guide how do I create a production-ready ZCode skill?

$zcode-mcp-plugin-en how do I configure an MCP server in ZCode?

$zcode-agent-en how should I structure my AGENTS.md file?

---

Example Prompts

Try these after installing the plugin:

How do ZCode skills work?

How should I create a custom skill?

What is the best structure for AGENTS.md?

How do I use Goal Mode effectively?

How do I debug a plugin that is not loading?

How do MCP servers work in ZCode?

---

Repository Structure

zcode-handbook-plugin/
├── README.md
├── LICENSE
├── .zcode-plugin/
│   └── marketplace.json
├── docs/
│   └── ZCode-Skill-Dokumantasyon.pdf
└── plugins/
    └── zcode-handbook-en/
        ├── .zcode-plugin/
        │   └── plugin.json
        ├── package.json
        ├── README.md
        ├── skills/
        └── commands/

---

Roadmap

Planned improvements:

• Turkish handbook plugin
• More troubleshooting examples
• Installation screenshots
• Short demo videos
• Skill templates
• MCP configuration examples
• Community-contributed ZCode recipes

---

Contributing

Contributions are welcome.

You can help by:

• Improving explanations
• Adding examples
• Expanding troubleshooting cases
• Adding new ZCode workflows
• Translating the handbook into other languages
• Reporting outdated or missing documentation

To contribute:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Open a pull request

---

Resources

• Official ZCode website: https://zcode.z.ai/en
• Official documentation: https://zcode.z.ai/en/docs/welcome

---

License

MIT — see LICENSE.