CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

archon-cli

Drive Archon through its CLI: run AI workflows on a repo, manage those runs (inspect, approve, reject, cancel, resume), set up Archon or change its config, author new workflows, and improve workflow prompts. 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/cancel/resume that run", "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.

79

Quality

99%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a model of progressive disclosure: an intent routing table, a lean quick-spine for the most common path with concrete detach/wait commands and an explicit input-validation gate, targeted gotchas (scope fallback semantics, outcome vs. completion), and clearly signaled one-level-deep references. It teaches only what is Archon-specific and assumes competence elsewhere.

DimensionReasoningScore

Conciseness

98 lines covering five capabilities with zero explanation of concepts Claude already knows — it never defines what a workflow, CLI, or worktree is. Every section carries archon-specific commands, flags, or behavioral rules (e.g., "treat `descriptionTruncated: true` as an explicit signal"); the few rhetorical flourishes ("at full price") are attached to hard rules and justify them rather than pad. This matches the lean/assumes-competence anchor, not the 4-anchor's trimmable over-explanation.

5 / 5

Actionability

Fully executable commands with flags for the dominant case: "archon workflow run <workflow> --branch <branch-name> \"<the work, as a clear message>\" --detach", plus "archon workflow list --json", "archon workflow list <name> --full", "archon workflow runs --json", "archon workflow wait <run-id> --json", "archon workflow get <run-id> --json". Copy-paste ready with specific guidance on when each applies ("wait" as a background task, "get" for on-demand state, not a polling loop).

5 / 5

Workflow Clarity

The quick spine is a clear six-step sequence with an explicit pre-launch validation checkpoint ("Check the input before spending anything... If any is missing, say which, propose a corrected input, and get the user's agreement before launching. Do not silently improve it, and do not launch anyway") and a post-run verification step ("A completed run does not mean the work succeeded. Use `workflow get <run-id> --json` for the normalized `outcome`"). Validation is present, so no cap applies; the error-recovery loop (propose corrected input → user agreement) satisfies the 5-anchor.

5 / 5

Progressive Disclosure

A routing table up front maps all five intents to one-level-deep reference files ("running-workflows/running-workflows.md", "manage-run/manage-runs.md", "setup-and-config/setup-and-config.md", "authoring-workflows/authoring-workflows.md", "prompting-mistakes/prompting-mistakes.md"), reinforced by a Resources section annotating each file's purpose — matching the clear-overview/well-signaled anchor. No bundle files were provided to verify, and the only nit is that authoring's "node-reference.md" appears in the routing table but not in the Resources list, which is too small to drop to the 4-anchor's "minor organization gaps".

5 / 5

Total

20

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it names all five capabilities concretely, provides a dozen natural trigger utterances with synonym coverage, and adds a NOT-for boundary that both clarifies scope and reduces conflict risk. It uses third-person/ imperative voice throughout with no padding.

DimensionReasoningScore

Specificity

The description enumerates every capability concretely: "run AI workflows on a repo", "manage those runs (inspect, approve, reject, cancel, resume)", "set up Archon or change its config", "author new workflows, and improve workflow prompts" — all five capabilities with specific verbs, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Explicitly answers both questions: what ("Drive Archon through its CLI" followed by the five capabilities) and when ("Use when the user says..." with a dozen concrete trigger phrases), plus a negative boundary ("NOT for: doing the coding work yourself — Archon delegates it to isolated runs") that sharpens the when further. Exceeds the 4-anchor, which only requires a present-but-less-explicit when.

5 / 5

Trigger Term Quality

Extensive natural user utterances including synonyms and variations: "use archon", "run archon", "archon workflow", "fix issue #N with archon", "have archon review this PR", "what's running / check run <id>", "approve/reject/cancel/resume that run", "set up archon", "configure archon", "change my archon config", "create a workflow", "author a workflow". Every phrase is something a user would plausibly actually say, satisfying the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

"archon" is a unique product name anchoring nearly every trigger, and the explicit "NOT for" clause fences off the main overlap risk (generic coding requests). The only archon-less triggers ("create a workflow", "author a workflow") correctly route to this skill's own authoring capability, so conflict risk is minimal — matching the clear-niche anchor rather than the minor-overlap anchor at 4.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

coleam00/Archon

Path

.claude/skills/archon-cli/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.