Skip to main content
Agent skill

Archon Cli

Drive Archon through its CLI: run AI workflows on a repo, watch and answer the runs that need a decision, drive the SDLC pack's queues (intake, build queue, merge queue, discoveries), set up Archon or change its config, and author and validate workflows. Use when the user says "use archon", "run archon", "archon workflow", "fix issue #N with archon", "have archon review this PR", "what's running / check run <id>", "approve/reject/answer/cancel/resume that run", "run the build queue", "drain discoveries", "set up archon", "configure archon", "change my archon config", "create a workflow", "author a workflow", or asks how to write a better Archon prompt. NOT for: doing the coding work yourself. Archon delegates it to isolated runs.

Get started

Get the complete skill folder, including its scripts and reference files.

When to use this skill

Use Archon Cli when an AI agent needs a reusable SKILL.md workflow for this job: Drive Archon through its CLI: run AI workflows on a repo, watch and answer the runs that need a decision, drive the SDLC pack's queues (intake, build queue, merge queue, discoveries), set up Archon or change its config, and author and validate workflows. Use when the user says "use archon", "run archon", "archon workflow", "fix issue #N with archon", "have archon review this PR", "what's running / check run <id>", "approve/reject/answer/cancel/resume that run", "run the build queue", "drain discoveries", "set up archon", "configure archon", "change my archon config", "create a workflow", "author a workflow", or asks how to write a better Archon prompt. NOT for: doing the coding work yourself. Archon delegates it to isolated runs.

When not to use it

Skip Archon Cli when the task is outside the productivity category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

Where will you use it?

Install scope
Claude Code folder setup
mkdir -p ~/.claude/skills/archon-cli
# Save SKILL.md to ~/.claude/skills/archon-cli/SKILL.md
  1. Claude Code personal install: place the skill and its bundled files at ~/.claude/skills/archon-cli/SKILL.md. For a shared project, commit the folder at .claude/skills/archon-cli/ instead.
  2. Current Claude Code detects SKILL.md changes in watched directories during the session. If you just created a top-level skills directory, run /reload-skills. Check that the skill is listed before testing its trigger.
  3. For Claude chat or Cowork in the Desktop app, manage uploaded skills in Customize > Skills; copying files into a local Claude Code folder is not a Desktop install. Other agents may use different install locations.

Full install guide for Claude, Cursor, and Codex →

Try a starter prompt

After installing the skill, paste this starter prompt into your agent to verify it triggers on a small task.

Starter prompt
Use the Archon Cli skill for this task: Use Archon Cli when this documented workflow matches the task. Confirm any required inputs or files before making changes.

What supports this recommendation?

70/100 provisional content score. This measures documentation, practical detail and source signals. It is not a measured task success rate or a security certification.

Documentation
77/100
Practical detail
68/100
Source evidence
63/100
Source signals
70/100
Model compatibility evidence
  • claudeinferred

    The skill text mentions Claude or a closely associated term. This is keyword-derived compatibility; no hands-on model test is recorded.

  • chatgptuntested

    No model-specific signal or recorded compatibility test was found.

  • geminiuntested

    No model-specific signal or recorded compatibility test was found.

  • copilotuntested

    No model-specific signal or recorded compatibility test was found.

  • llamauntested

    No model-specific signal or recorded compatibility test was found.

  • perplexityuntested

    No model-specific signal or recorded compatibility test was found.

  • mistraluntested

    No model-specific signal or recorded compatibility test was found.

  • grokuntested

    No model-specific signal or recorded compatibility test was found.

Inferred compatibility is based on content signals. Check the app, its available tools and setup requirements before running a skill.

What this skill does

# Archon CLI

Archon runs multi-step AI workflows through the `archon` CLI. Git projects run in isolated worktrees by default; registered folder projects run in place. You sit on top of the runs: you write the brief, launch, watch one stream, answer the decisions that reach you, and read what each run left behind.

Route by intent:

| The user wants to... | Read | |---|---| | Run a workflow on real work | `operate/running.md` | | Inspect, answer, cancel or resume runs | `operate/managing-runs.md` | | Drive the SDLC pack's queues | `operate/queues.md` | | Find out why a run failed or hangs | `operate/troubleshooting.md` | | Set up Archon or change config | `setup/setup-and-config.md` | | Author or change a workflow | `authoring/authoring-workflows.md` (then `node-reference.md` and `variables.md` in the same folder) | | Improve a node prompt or a run message | `authoring/prompting-mistakes.md` |

- When the intent is clear ("build me a workflow for X", "run archon-ship on issue #42"), go straight to the reference. Do not ask. - When it is ambiguous, ask which of these the user wants. - On a machine where `archon doctor` fails, start with `setup/setup-and-config.md`.

## The operating loop

1. **Discover.** `archon workflow list --json` gives compact descriptions. For each plausible candidate, read the full description with `archon workflow list <name> --full`. Choose from full descriptions, never from names you remember. 2. **Check the brief.** The message, issue body or document the run reads is the contract the run is measured against. It must state the problem, why it is worth solving, why now, the desired outcome, the invariants and the acceptance. If any is missing, say which, propose wording, and get the user's agreement before launching. `operate/running.md` has the full check. 3. **Launch detached.** Pass the work as a message, the workflow's declared inputs with `--input`, or both:

```bash archon workflow run <workflow> --branch <branch-name> "<the work>" --detach archon workflow run <workflow> --input <name>=<value> --input <name>=<value> --detach ```

4. **Watch once.** Run one stream as a background task of your harness, however many runs you launched:

```bash archon workflow attention --watch --json # this project; add --all for the install ```

Each line is JSON. `attention` means a run needs a decision, `resolved` means it no longer does, and `terminal` means a run ended. Act on the line, then keep reading. 5. **Answer deliberately.** Read the item's question, its recommendation and the evidence it links. Answer with a reason, detached: `archon workflow respond <run-id> <decision> "<reason>" --detach`. `operate/managing-runs.md` covers every form. 6. **Read the result.** A completed run is not a verdict. `archon workflow get <run-id> --json` gives the normalized `outcome` and `leave_behind.artifactFiles`. Read the report before telling the user what the run concluded.

## Hard rules

- **Never launch on a thin brief.** A weak input does not produce a weak result. It produces a confident, well-formed answer to the wrong question, at full price. - **Launch and answer with `--detach`.** A detached run starts its own session and survives your shell. A foreground `respond` or `resume` continues the run inside your shell, and closing the shell stops it. - **One watcher, not one per run.** One `workflow attention --watch` stream covers every run in scope, including runs that triggers or other sessions start. A `workflow wait <run-id>` per run is fine for one or two runs; with dozens it contends for the database. - **Stop work only when you mean to end it.** `archon workflow cancel` stops the run mid-node, and that node's provider session and unsaved work are lost. Let a run reach its next pause or end when you only want to stop launching more. When one turn is stuck on a tool or background command that never finishes, `archon workflow end-turn <run-id>` ends that turn and keeps the run (`operate/managing-runs.md`, "A stalled turn"). - **Merge only what was reviewed.** When you merge a pull request by hand, pin the merge to the reviewed head (`gh pr merge <n> --match-head-commit <sha>`), read the open review threads first, and sync your checkout afterwards. - **Author agent-first.** In a workflow you write, an agent node with typed output judges, scripts read facts and act at boundaries, and YAML only wires them. `authoring/authoring-workflows.md` ("Agent-first") has the rule and an example.

## Gotchas

- The current directory selects the project for discovery, launches and project listings. `workflow status`, `workflow runs` and `workflow attention` default to that project; add `--all` for the whole install. For a git project, run from the repo root. Register a non-git folder with `workflow run --folder`. A full run ID works from any directory. - Attention items are paused runs. A running run stuck on a stalled tool call is not an item: `workflow wait <run-id>` and `workflow status` show it. - `workflow status` and `workflow runs` set `scopeFallback: true` in JSON when an unregistered project produced an install-wide result. - Prefer `--json` whenever you will parse output. - `archon --help` is authoritative. If a flag this skill names is rejected, trust the CLI's help and tell the user about the drift.

Intended uses

  • Use Archon Cli when this documented workflow matches the task.

Implementation notes

  • Review the source instructions and adapt inputs before running the workflow.

Try it, then tell us how it went

A copied prompt does not tell us whether the task worked. Report your result after checking the output. We collect your tool and outcome, never your files or prompt.