CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

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.

An exemplary CLI-driving skill body: a routing table for discovery, a concrete operating loop with commands, hard rules that state consequences rather than prohibitions, and gotchas that are all non-obvious. Validation checkpoints precede every risky action (launch, merge, cancel) and the structure defers all detail to clearly signaled one-level-deep references.

DimensionReasoningScore

Conciseness

The body teaches only non-obvious, Archon-specific behavior ('A detached run starts its own session and survives your shell', 'with dozens it contends for the database') with no padding or explanations of concepts Claude already knows. Every section — routing table, operating loop, hard rules, gotchas — carries information Claude could not infer.

5 / 5

Actionability

Fully executable commands cover the common cases: `archon workflow run <workflow> --branch <branch-name> "<the work>" --detach`, `archon workflow attention --watch --json`, `archon workflow respond <run-id> <decision> "<reason>" --detach`, `archon workflow get <run-id> --json`, and `gh pr merge <n> --match-head-commit <sha>`. Nothing is pseudocode or abstract.

5 / 5

Workflow Clarity

The operating loop is a clear six-step sequence (Discover, Check the brief, Launch detached, Watch once, Answer deliberately, Read the result) with explicit validation checkpoints ('get the user's agreement before launching', 'Read the report before telling the user what the run concluded', 'read the open review threads first' before merge). Destructive operations (cancel, hand-merge) carry consequence warnings and safer alternatives (`end-turn`, match-head-commit), and stalled/failed runs route to troubleshooting — so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The intent-routing table ('The user wants to... | Read') maps every intent to a one-level-deep reference file, and inline pointers cite exact sections ('operate/managing-runs.md, "A stalled turn"'). The body is a lean overview that appropriately defers detail to the referenced files; no content that belongs in a separate file is inlined.

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.

A model description: concrete capabilities, an explicit trigger list with natural phrasing and synonyms, and a clear negative boundary. It answers what and when without padding, and its product-anchored triggers make mis-triggering unlikely.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: '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'. Not score 4, which requires minor gaps in coverage — operating, queue-driving, setup, and authoring are all explicitly named.

5 / 5

Completeness

Both questions are answered explicitly: a concrete 'what' (the action list) and an explicit 'when' with quoted trigger phrases ('Use when the user says...'), plus a negative boundary ('NOT for: doing the coding work yourself'). This matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrasing including synonyms and variants: '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', 'drain discoveries', 'set up archon' / 'configure archon' / 'change my archon config', 'create a workflow' / 'author a workflow'. Matches the 5 anchor (natural terms, synonyms, and variations) rather than the 4 anchor (a few natural terms missing).

5 / 5

Distinctiveness Conflict Risk

Clear niche — delegating work to isolated Archon runs via its CLI — with distinct triggers tied to the product name and an explicit NOT-for clause separating it from doing the coding work directly. Minimal conflict risk with other skills.

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.