/archon

name: archon
description: |
  Use when: User wants to run Archon workflows, CREATE workflows or commands,
  set up Archon, or manage Archon configuration.
  Triggers (run): "use archon to", "run archon", "archon workflow", "use archon for",
            "have archon", "let archon", "ask archon to".
  Triggers (create): "create a workflow", "write a workflow", "make a command",
            "author a workflow", "new workflow", "new command", "archon workflow yaml".
  Triggers (setup): "set up archon", "install archon", "how to use archon",
            "configure archon", "archon setup", "get started with archon".
  Triggers (config): "change my archon config", "modify archon config", "archon config",
            "change archon settings", "update my config", "help me change my config",
            "edit archon config", "archon configuration".
  Triggers (init): "initialize archon", "set up .archon", "archon init", "add archon to repo".
  Capability: Runs AI workflows in isolated git worktrees for parallel development.
  Also: Creates and manages workflow YAML files, command files, and configuration.
  NOT for: Direct Claude Code work - only for delegating to Archon CLI.
argument-hint: "[workflow] [message or issue number]"

Archon CLI Skill

Archon is a remote agentic coding platform that runs AI workflows in isolated git worktrees. This skill teaches you how to run workflows, create new workflows and commands, and manage Archon configuration.

Available Workflows (live)

!`archon workflow list 2>&1 || echo "Archon CLI not installed. Read guides/setup.md to set it up."`

Routing

Determine the user's intent and dispatch to the appropriate guide:

| Intent | Action | |--------|--------| | **Setup / install / "how to use"** | Read `guides/setup.md` — interactive setup wizard | | **Config / settings** | Read `guides/config.md` — interactive config editor | | **Initialize .archon/ in a repo** | Read `references/repo-init.md` | | **Create a workflow** | Read `references/workflow-dag.md` — the complete workflow authoring guide | | **Quick parameter lookup — which field works on which node type** | Read `references/parameter-matrix.md` — master matrix, intent-based lookup, silent-failure catalog | | **Advanced features (hooks/MCP/skills)** | Read `references/dag-advanced.md` | | **Create a command file** | Read `references/authoring-commands.md` | | **Variable substitution reference** | Read `references/variables.md` | | **CLI command reference** | Read `references/cli-commands.md` | | **Run an interactive workflow** | Read `references/interactive-workflows.md` — transparent relay protocol | | **Workflow good practices / anti-patterns** | Read `references/good-practices.md` — read before designing a non-trivial workflow | | **Troubleshoot a failing / stuck workflow** | Read `references/troubleshooting.md` — log locations, common failure modes | | **Run a workflow (default)** | Continue with "Running Workflows" below |

If the intent is ambiguous, ask the user to clarify.

---

Richer Context: [archon.diy](https://archon.diy)

The references in this skill are a distilled subset. The full, canonical docs live at **[archon.diy](https://archon.diy)** (Starlight site from `packages/docs-web/`). If the skill's reference pages don't cover what you need — an edge case, a worked example, a diagram, a deeper section on a feature — fetch the matching page from archon.diy.

When to reach for the live docs

• You need an end-to-end example that's longer than what the skill shows (e.g. full patterns for hooks, MCP config, sandbox schema, approval flows)
• You're explaining a concept to the user and want the most readable framing (the `book/` series is written as a tutorial, not a reference)
• You hit a feature the skill only mentions in passing (e.g. `agents:` inline sub-agents, advanced Codex options, the full SyncHookJSONOutput schema)
• The user asks "where is this documented?" — point them at the archon.diy URL, not a skill file path

URL map

| Topic | URL | |-------|-----| | Landing + install | [archon.diy](https://archon.diy) | | Getting started (installation, quick start, concepts) | [archon.diy/getting-started/](https://archon.diy/getting-started/overview/) | | The book (tutorial-style walkthrough) | [archon.diy/book/](https://archon.diy/book/) | | Workflow authoring guide | [archon.diy/guides/authoring-workflows/](https://archon.diy/guides/authoring-workflows/) | | Command authoring guide | [archon.diy/guides/authoring-commands/](https://archon.diy/guides/authoring-commands/) | | Node type guides | [archon.diy/guides/loop-nodes/](https://archon.diy/guides/loop-nodes/), [/approval-nodes/](https://archon.diy/guides/approval-nodes/), [/script-nodes/](https://archon.diy/guides/script-nodes/) | | Per-node features (Claude only) | [/hooks/](https://archon.diy/guides/hooks/), [/mcp-servers/](https://archon.diy/guides/mcp-servers/), [/skills/](https://archon.diy/guides/skills/) | | Global workflows/commands/scripts | [archon.diy/guides/global-workflows/](https://archon.diy/guides/global-workflows/) | | Variables reference | [archon.diy/reference/variables/](https://archon.diy/reference/variables/) | | CLI reference | [archon.diy/reference/cli/](https://archon.diy/reference/cli/) | | Security model (env, sandbox, target-repo `.env` stripping) | [archon.diy/reference/security/](https://archon.diy/reference/security/) | | Architecture | [archon.diy/reference/architecture/](https://archon.diy/reference/architecture/) | | Configuration (`.archon/config.yaml` full schema) | [archon.diy/reference/configuration/](https://archon.diy/reference/configuration/) | | Troubleshooting | [archon.diy/reference/troubleshooting/](https://archon.diy/reference/troubleshooting/) | | Adapter setup (Slack/Telegram/GitHub/Web/Discord/Gitea/GitLab) | [archon.diy/adapters/](https://archon.diy/adapters/) | | Deployment (Docker, cloud, Windows) | [archon.diy/deployment/](https://archon.diy/deployment/) |

URL sha