acp-builder-setup

name	acp-builder-setup
description	Set up ACP builder workflows for Codex, Claude Code, and Claude Desktop. Use when installing ACP skills, configuring Codex or Claude to use Virtuals-hosted models, or checking builder environment readiness.

ACP Builder Setup

Use this skill to help a builder get ready to run ACP demos and skills. There are two separate jobs, and they have very different stakes:

1. Install the ACP skill — required. Just copies files into the agent runtime. Safe.
2. Route through Virtuals for free credits — optional. Edits the user's global agent config. Fully reversible, but get the user's OK first.

Do flow 1 for everyone. Only do flow 2 if the user wants to use Virtuals' free inference credits instead of their own Anthropic/OpenAI account.

Surface Selection

First identify the target surface — it decides which commands apply:

• Codex CLI or Codex Desktop local thread: can use local files, acp-cli, ~/.agents/skills, and ~/.codex/config.toml.
• Claude Code terminal: can use local files, acp-cli, ~/.claude/skills, and claude-code-router.
• Claude Desktop app: uses uploaded Skills from Claude settings. It does not read ~/.claude/skills or claude-code-router, so flow 2 (routing) does not apply — use the ZIP upload path instead.

If the target surface is unclear, ask which tool they are setting up before changing files.

1. Install the ACP skill (required)

This installs the demo skills into the runtime. It only copies or links files — no global config is touched.

Use this repo as the source of truth. Prefer symlinks for local development and copies for one-off installs. For exact commands, read .