| name | setup |
| description | First-run workspace setup. Use when the user says "set up this workbench", "run setup", or asks how to get started in a fresh clone, to pick runtimes (Claude Code, Codex, or both), personalize local settings, and walk the connector checklist. |
Setup
Tailor a fresh clone of the AI Workbench to its owner. One repo serves Claude Code users, Codex users, and people who run both; this skill configures (or prunes) accordingly so nobody carries files for a tool they do not use. Everything destructive is approval-gated: propose, list exactly what would change, apply only what the user approves.
Step 1: Detect state
- If
personal/docs/setup-receipt.md exists, this is a re-run: read it, say what was configured before, and ask what to change.
- Note what exists:
.claude/settings.local.json, .mcp.json, existing personal/ content. Never treat a workspace with journal or draft content as fresh; skip anything already done.
Step 2: Ask which runtimes
Ask once: Claude Code only, Codex only, or both?
Then tailor:
- Both (the shipped default): change nothing structural. Remind:
.claude/skills/ is canonical, .agents/skills/ is the mirror, and ./scripts/sync-codex-skills.sh --write runs after any skill edit.
- Claude Code only: propose removing the Codex surface:
.codex/ and .agents/. Also update AGENTS.md: drop the sync-script line from AI Harness Checks and the Codex tier column from the routing table. AGENTS.md itself stays; it is the canonical guide that CLAUDE.md imports.
- Codex only:
AGENTS.md and .agents/skills/ are what Codex reads, so the workspace works as-is. Offer (do not push) a prune of the Claude-specific surface: , , , , and . If pruning, first make canonical: copy over it, then retire the sync script and update to match. Note honestly that the slash-command workflows in have no direct Codex equivalent; the durable capabilities live in skills.