Primary navigation

Customization

Shape ZeroTwo using project guidance, skills, MCP servers, and subagents

ZeroTwo is customized through five cooperating layers: instruction files such as AGENTS.md, Memories, skills, connectors and MCP servers, and Subagents. Plugins bundle several of these, and the Customize section is where you browse and install them.

AGENTS Guidance

An instruction file carries short, durable rules for a project: commands, review expectations and conventions. ZeroTwo reads one file from the project root, choosing the first non-empty one of ZEROTWO.md, AGENTS.md and CLAUDE.md; the files do not merge. It reads a second one the same way from ~/.zerotwo/ for personal preferences. Edits are picked up during a session, and cloud runs read the same names from the cloned repository.

When to update AGENTS.md

  • Add a rule after repeated mistakes or repeated review feedback.
  • Add routing hints if ZeroTwo reads too many files.
  • Run /init in a desktop Work or Code chat to have the agent draft the file.

Pair rules with hooks and linters. For personal tone and preferences that are not tied to a project, use Custom instructions under Settings > Personalization. See Custom instructions with AGENTS.md.

Guidance comes from two locations, a global file for you and a project file for your team:

  • ~/.zerotwo/
    • AGENTS.mdGlobal (for you)
  • repo-root/
    • AGENTS.mdProject (for your team)

Skills

A skill is a folder with a SKILL.md plus optional scripts/, references/ and assets/, ideal for repeatable workflows. ZeroTwo keeps each skill's name and description in context, loads the body when a skill is chosen, and reads extras on demand. Skills can also ship inside a plugin.

  • my-skill/
    • SKILL.mdRequired: instructions + metadata
    • scripts/Optional: executable code
    • references/Optional: documentation
    • assets/Optional: templates, resources
---
name: commit
description: Stage and commit changes in semantic groups.
---

On desktop, your personal skills live in ~/.zerotwo/skills/<slug>/, and skills inside a project's .claude/skills or .agents/skills folder are found too. The simplest way to write one is to ask ZeroTwo to create it with the Skill Creator skill, or, on macOS, record a workflow with Record a skill. See Build skills.

MCP

MCP connects ZeroTwo to servers that expose tools, such as Figma, Linear or GitHub. Most are available as Connectors in Customize, and you can add your own server from Settings > Plugins. Use it for anything outside the project, and set each tool to Always allow, Needs approval or Blocked. Skills usually name which tools to call. See Model Context Protocol.

Subagents

Define role-specific agents, for example one for tests and one with log-fetching tools, so each stays focused. Custom agents are Markdown files with frontmatter, listed under Customize > Agents. See Subagents.

Skills + MCP together

Skills define the process, and connectors and MCP servers reach the systems. A skill can tell ZeroTwo which connector tools to use for each step.

Next step

  1. AGENTS.md

    Start with Custom instructions with AGENTS.md.

  2. Plugin or skill

    Install a plugin or write a skill.

  3. MCP

    Add MCP for external systems.

  4. Subagents

    Delegate noisy work to subagents.