archon

Runs and authors Archon AI workflows in isolated git worktrees via the Archon CLI.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Jutxica/ia-conversacional-rag --skill archon-jutxica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archon
Source: https://github.com/Jutxica/ia-conversacional-rag/tree/main/.claude/skills/archon
Command: npx skills add https://github.com/Jutxica/ia-conversacional-rag --skill archon-jutxica

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating multi-step AI coding work — fixing issues, reviewing PRs, implementing features — requires orchestrating prompts, scripts, approvals, and git isolation by hand. This Skill teaches the AI to run, author, and configure Archon workflows so that complex agentic tasks execute as structured DAG workflows in isolated git worktrees. ## Core Features & Use Cases - Run workflows: Dispatch built-in workflows (fix GitHub issues, review PRs, implement plans) as background tasks with worktree isolation via archon workflow run. - Author workflows and commands: Create YAML DAG workflows with command, prompt, bash, script, loop, approval, and cancel nodes, plus Markdown command templates with variable substitution. - Setup and configuration: Interactive guides for installing the CLI, editing global and repo-level config, initializing .archon/ in a repo, and connecting platforms like GitHub and Discord. - Use Case: A user says "Use Archon to fix issue #42" — the Skill selects archon-fix-github-issue, runs it in the background on branch fix/issue-42, and monitors progress without touching the main checkout. ## Quick Start Ask the assistant to use Archon to fix a specific GitHub issue or review a pull request by number.

Frequently Asked Questions about archon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an Archon workflow to fix a GitHub issue?

Run `archon workflow run archon-fix-github-issue --branch fix/issue-42 "Fix issue #42"` from within the git repository. Always run it as a background task since workflows are long-running, and use the --branch flag so work happens in an isolated git worktree.

How do I create a custom Archon workflow?

Write a YAML file in .archon/workflows/ defining nodes, where each node has exactly one of command, prompt, bash, script, loop, approval, or cancel. Validate it with `archon validate workflows <name>` before running to catch YAML, DAG, and reference errors.

What node types does an Archon workflow support?

Seven node types exist: command (loads a Markdown command file), prompt (inline AI prompt), bash (shell script), script (TypeScript via bun or Python via uv), loop (iterates until a condition), approval (human gate), and cancel (terminates the run).

Does Archon support Codex as well as Claude?

Yes, workflows can set provider to claude or codex, and providers can be mixed per node. However, hooks, per-node MCP servers, skills, and tool restrictions are Claude-only; Codex uses global configuration in ~/.codex/config.toml instead.

Why is my Archon workflow node being skipped or ignored?

Common causes include invalid when: expressions (which fail closed and skip the node), AI-only fields like model or hooks set on bash/script/loop nodes (silently ignored), or trigger_rule: all_success after conditional branches where skipped dependencies block the join node.

How do I handle approval gates in an interactive Archon workflow?

Set interactive: true at the workflow level, then monitor `archon workflow status` until it shows paused. Relay the workflow's output verbatim to the user and resume with `archon workflow approve <run-id> "<user response>"` or reject with a reason.