skills.rest
softmg
softmgOFFICIAL
Explore all skills by this author →
GitHub

archon

Runs and authors Archon CLI workflows that execute AI agents in isolated git worktrees.

Updated May 8, 2026
Search Tags:#workflow automation#cli#ai agents#git worktree#github issues#archon#dag
One-click install
npx skills add https://github.com/softmg/tile-turf --skill archon-softmg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: archon
Source: https://github.com/softmg/tile-turf/tree/main/.agents/skills/archon
Command: npx skills add https://github.com/softmg/tile-turf --skill archon-softmg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating multi-step AI coding tasks—fixing issues, reviewing PRs, implementing features—requires orchestrating agents, branches, and artifacts manually. This Skill teaches the AI to operate the Archon CLI so workflows run in isolated git worktrees without touching the main branch. ## Core Features & Use Cases - Workflow Execution: Run bundled workflows like archon-fix-github-issue or archon-comprehensive-pr-review as background tasks with worktree isolation via --branch. - Workflow & Command Authoring: Create DAG-based YAML workflows (prompt, bash, script, loop, approval, cancel nodes) and Markdown command files in .archon/commands/. - Setup & Configuration: Guides for CLI installation, repo initialization, config editing, and troubleshooting failed runs. - Use Case: Ask the assistant to "fix issue #42 with Archon" and it dispatches archon workflow run archon-fix-github-issue --branch fix/issue-42 in the background, then monitors progress. ## 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"` as a background task. The `--branch` flag creates an isolated git worktree so the workflow never touches your main checkout.

How do I create a custom Archon workflow?▼

Write a YAML file in `.archon/workflows/` defining nodes with types like `command`, `prompt`, `bash`, `script`, `loop`, or `approval`, connected via `depends_on`. Validate it with `archon validate workflows <name>` before running.

What is the difference between Archon command nodes and prompt nodes?▼

Command nodes load a reusable Markdown prompt template from `.archon/commands/`, while prompt nodes contain an inline AI prompt directly in the workflow YAML. Both execute AI agents; command files are shareable across workflows.

Does Archon support Codex as well as Claude?▼

Yes, workflows can set `provider: claude` or `provider: codex`, and individual nodes can override the model. However, hooks, MCP servers, and skills are Claude-only per-node features; Codex uses global config in `~/.codex/config.toml`.

Why did my Archon workflow fail or get stuck?▼

Check the run log at `~/.archon/workspaces/<owner>/<repo>/logs/<run-id>.jsonl` and run `archon workflow status`. Common causes include missing `trigger_rule` after conditional branches, `context: fresh` nodes lacking artifacts, or retry set on a loop node.

Can I run multiple Archon workflows at the same time?▼

Yes, run each workflow as a separate background task with its own `--branch` name so each gets an isolated worktree. Never combine multiple issues into a single workflow invocation.

Related Skills

Explore More Software Engineering Skills→
JutxicaJutxica

archon

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

Community
Advanced
koala-man-64koala-man-64

git-hygiene-orchestrator

Audit and clean Git branches, remote-tracking refs, and worktrees with evidence-based safety gates.

Community
Advanced
4tie4tie

validation

N/A

Community
Intermediate
xtrm-devxtrm-dev
4

using-specialists

Route substantial AI tasks to specialist agents with bead-first tracking and merge-gated orchestration.

Official
Advanced