duet command-line tool, and the action for each diagnostic the tool prints. The skill runs the duet tool at the version your tree pins, and names no version itself: it reads your tree’s pins.
What the skills teach
A Duet tree uses all three: the
duet skill sends the agent to the other two for test doubles.
In Modaal
Modaal’s agent works from Modaal’s own Duet instructions and tools in every Modaal project. Install the skill for an agent you run yourself, outside Modaal, on a Duet tree. When an environment provides its own Duet instructions or tools, the skill tells the agent to follow those first.Claude Code
Add the marketplace, then install the plugin:claude plugin marketplace add modaal-agent/duet and claude plugin install duet-ios-android@modaal-duet do the same. The plugin adds about 400 tokens to every session for the skill’s description, and about 4,500 when the skill runs.
A team
Commit the marketplace and the plugin to the repository’s.claude/settings.json:
enabledPlugins turns the plugin on; it does not download it. Each collaborator runs this once in the repository:
Other agents
Theskills command installs the skill into Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and the other agents it supports:
-g to install it for every project, or --list to see what the repository holds without installing. The test-double skills install the same way: npx skills add modaal-agent/kotlin-ksp-mocks and npx skills add modaal-agent/swift-sourcery-templates.
By hand
Copy the skill’s directory into your agent’s skills directory:.claude/skills/ inside a repository instead to install it for that repository only.
claude.ai and the Claude API
Zip theskills/duet/ directory and upload it as a custom skill, following Anthropic’s Using Skills in Claude. For the API, create it with POST /v1/skills, sending the directory’s files under one top folder. The skill’s frontmatter carries only the standard keys, so the directory uploads unedited.
Optional: the CLI as an MCP server
duet mcp serves the verification commands (verify, lint, record, lanes, explain, materialize, protocol-run, scope, doctor) as MCP tools over stdio. Launch it with its working directory inside the tree:
tools/duet wrapper, set command to the wrapper’s path so the server runs the version the tree pins.
Check that it loaded
In Claude Code,/plugin lists Duet by Modaal: verifiable iOS and Android twins app architecture. Ask the agent “what does duet record --check do?” in a Duet tree: the answer starts by invoking the duet skill.
Updating
The plugin has its own version, which rises with each change to the skill; a duet release that leaves the skill unchanged leaves it.claude plugin list shows the installed version. Fetch the newest with:
npx skills install, run npx skills add modaal-agent/duet again.