run SKILL.md skillA

run from phnx-labs/agi-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add phnx-labs/agi-cli/run@git:20261020.6a23d55

Pins git:20261020.6a23d55 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
phnx-labs/agi-cli
Path
skills/run/SKILL.md
Versions recorded
11
Latest version
git:20261020.2336f82, committed Oct 20, 2026
First version recorded
Aug 10, 2026
Size
20,355 bytes
Repository stars
25
License
a license file GitHub does not identify

Execute a single agent headlessly or interactively. Supports plan/edit/auto/skip modes, secrets bundle injection, version pinning, fallback chains, balanced rotation, profile dispatch (Kimi/DeepSeek/etc.), and workflow dispatch by name. Triggers on: 'run claude', 'run codex', 'agents run', 'dispatch an agent', 'headless agent', 'one-off agent task'.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Run Skill

Dispatch a single agent for a one-off task. `agents run` is the fundamental command for interactive sessions and headless automation across Claude, Codex, Gemini, Cursor, OpenCode, and OpenClaw.

## Headless vs interactive

Explicit flags are definitive; otherwise the mode is inferred from prompt presence:

- `--interactive` (`-i`) → always interactive, even with a prompt (the prompt is forwarded as the first message).
- `--headless` → always headless, even with no prompt (the prompt is read from stdin).
- Neither flag, **prompt provided** → headless. Pipes stdout, no TTY, exits when the agent finishes.
- Neither flag, **prompt omitted** → interactive. Launches the agent's TUI with full stdio inheritance.

`--interactive` and `--headless` are mutually exclusive — passing both errors out.

```bash
# Interactive (TUI)
agents run claude

# Headless one-shot
agents run claude "summarize recent git commits"
```

## Modes

Permission mode controls what the agent can do.

| Mode | What it allows |
|------|----------------|
| `plan` (default) | Read-only — research, audit, analysis. No writes, no shell side-effects. |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add phnx-labs/agi-cli/run@sha256:caf16a3b389e34ae

The line at the top of this page pins the label git:20261020.6a23d55, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_si4ilfmar2ytcddt.svg)](https://markdownregistry.com/a/art_si4ilfmar2ytcddt)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 11 versions of this file, between Aug 10, 2026 and Oct 20, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261020.2336f82 latest2026-10-20 2336f82 20,355 BA view · diff
git:20261020.6a23d552026-10-20 6a23d55 20,335 BA view · diff
git:20261017.baba0f12026-10-17 baba0f1 20,330 BA view · diff
git:20261012.084dfac2026-10-12 084dfac 20,435 BA view · diff
git:20261011.477472d2026-10-11 477472d 20,436 BA view · diff
git:20261011.ee62daa2026-10-11 ee62daa 20,512 BA view · diff
git:20260901.f75a6652026-09-01 f75a665 20,473 BA view · diff
git:20260827.6d51fa52026-08-27 6d51fa5 20,479 BA view · diff
git:20260815.f2a9ef12026-08-15 f2a9ef1 20,333 BA view · diff
git:20260810.29b06032026-08-10 29b0603 20,312 BA view · diff
git:20260810.2651a152026-08-10 2651a15 20,258 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (20355 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

phnx-labs/agi-cli · 25 stars · license a license file GitHub does not identify · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_si4ilfmar2ytcddt
GET https://markdownregistry.com/api/v1/resolve?ref=phnx-labs/agi-cli/run
GET https://markdownregistry.com/api/v1/blob/caf16a3b389e34ae5a628f42262073747f2dc7c14157b1a09df12a3327576f62

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from phnx-labs/agi-cli

DESIGN.md@.agents/artifacts/2026-08-21 DESIGN.md file
phnx-labs/agi-cli · .agents/artifacts/2026-08-21/DESIGN.md
git:20260822.0edb90f · audit A · 25 stars
DESIGN.md@.agents/artifacts/2026-08-25 DESIGN.md file
phnx-labs/agi-cli · .agents/artifacts/2026-08-25/DESIGN.md
git:20260825.b3c3383 · audit A · 25 stars
DESIGN.md@.agents/artifacts/2026-09-05 DESIGN.md file
phnx-labs/agi-cli · .agents/artifacts/2026-09-05/DESIGN.md
git:20260906.5d705eb · audit B · 25 stars
DESIGN.md@.agents/artifacts/2026-09-06/account-model-v2 DESIGN.md file
phnx-labs/agi-cli · .agents/artifacts/2026-09-06/account-model-v2/DESIGN.md · The meta harness engineering system for agents. A Phoenix Labs source-available product (FSL-1.1-Apache-2.0)…
alpha · audit A · 25 stars
DESIGN.md@.agents/artifacts/2026-09-06/secrets-extraction DESIGN.md file
phnx-labs/agi-cli · .agents/artifacts/2026-09-06/secrets-extraction/DESIGN.md
git:20260906.a8060ea · audit A · 25 stars
DESIGN.md@.agents/artifacts/2026-09-06/share-extraction DESIGN.md file
phnx-labs/agi-cli · .agents/artifacts/2026-09-06/share-extraction/DESIGN.md
git:20260913.851b11f · audit A · 25 stars
AGENTS.md AGENTS.md file
phnx-labs/agi-cli · AGENTS.md
git:20261020.4f00dc6 · audit A · 25 stars
CLAUDE.md CLAUDE.md file
phnx-labs/agi-cli · CLAUDE.md
git:20260208.4be496d · audit B · 25 stars
DESIGN.md DESIGN.md file
phnx-labs/agi-cli · DESIGN.md · The meta harness engineering system for agents. A Phoenix Labs source-available product (FSL-1.1-Apache-2.0)…
alpha · audit A · 25 stars
AGENTS.md@cli AGENTS.md file
phnx-labs/agi-cli · cli/AGENTS.md
git:20261020.ac859d7 · audit B · 25 stars
CLAUDE.md@cli CLAUDE.md file
phnx-labs/agi-cli · cli/CLAUDE.md
git:20260825.72ebbe6 · audit B · 25 stars
image SKILL.md skill
phnx-labs/agi-cli · cli/src/commands/__tests__/testdata/stats-plugin-names/agents/plugins/create/skills/image/SKILL.md · Generate an image.
git:20261006.5fb8d40 · audit B · 25 stars

Every file in phnx-labs/agi-cli

Other files named run

run SKILL.md skill
agent-sh/agnix · tests/fixtures/claude-ext/plugin/skills/run/SKILL.md · Runs the bundled tool. Use when asked to run the fixture tool.
git:20261017.b221410 · audit B · 455 stars
run SKILL.md skill
jmagly/aiwg · agentic/code/addons/aiwg-utils/skills/run/SKILL.md · Execute a named script defined in .aiwg/aiwg.config or list all available scripts
git:20260430.6d8a12e · audit B · 225 stars
run SKILL.md skill
swingerman/engineer · engineer/skills/run/SKILL.md · Use to drive one feature from CP2 to CP8 under a coordinator. It proposes the feature's agent graph (shapes, model…
git:20261020.a98004e · audit A · 157 stars
run SKILL.md skill
rustyrazorblade/skills · plugins/easy-db-lab/skills/run/SKILL.md · Executes a plan step by step in an explicit cluster workspace, confirming each step with the user, journaling as work…
git:20261015.299444a · audit A · 44 stars
run SKILL.md skill
borda/ai-rig · plugins/cc_research/skills/run/SKILL.md · Sustained metric-improvement loop with atomic commits, auto-rollback, and experiment logging. Iterates with specialist…
git:20261009.94fe089 · audit A · 28 stars
run SKILL.md skill
chainlesschain/chainlesschain · packages/cli/src/skills-bundled/run/SKILL.md · Launch and drive this project's app to see a change actually working — not just passing tests. Use when asked to run…
git:20260614.c74dd9d · audit A · 11 stars
run SKILL.md skill
dmitriyyukhanov/agent-plugins · plugins/issue-to-pr/skills/run/SKILL.md · Drive a GitHub issue — bare or tracked on a Project board — from triage to a merge-ready PR through a gated pipeline…
git:20261011.faf2ccf · audit A · 8 stars
run SKILL.md skill
dmitriyyukhanov/claude-plugins · plugins/issue-to-pr/skills/run/SKILL.md · Drive a GitHub issue — bare or tracked on a Project board — from triage to a merge-ready PR through a gated pipeline…
git:20261011.faf2ccf · audit A · 8 stars

Browse by kind, by grade A, or by owner.