runx SKILL.md skillB

runx from runxhq/runx is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add runxhq/runx/runx@git:20261017.16ba3f9

Pins git:20261017.16ba3f9 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
runxhq/runx
Path
SKILL.md
Versions recorded
11
Latest version
git:20261017.16ba3f9, committed Oct 17, 2026
First version recorded
Jul 16, 2026
Size
9,845 bytes
Repository stars
105
License
Apache-2.0

Governed runtime for agent skills: discover and install portable skills, run bounded skill graphs with explicit authority, and inspect signed receipts for what happened.

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

# runx

References: [spec](https://runx.ai/spec), [catalog](https://runx.ai/x),
[doctrine](https://runx.ai/doctrine), [overview](https://runx.ai/what),
[source](https://github.com/runxhq/runx).

runx is the governed runtime for agent skills. Use it when an agent needs to do
real work through a portable skill while preserving four properties:

1. the skill being run is explicit;
2. the authority granted to it is bounded;
3. consequential actions pass through a gate;
4. the run leaves a signed receipt that can be inspected later.

A runx skill is not just a prompt. It is a small, portable package with a
`SKILL.md` contract, optional graph/config files, and enough procedural context
for an agent to execute deliberately instead of improvising hidden side effects.

## When to use runx

Use runx when the task involves one or more of these:

- running a third-party or project-owned skill from a catalog, repo, or local path
- chaining multiple skill steps into a bounded workflow
- touching money, credentials, deployments, public messages, production systems,
  customer data, or other consequential surfaces
- proving what happened after an agent acted
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add runxhq/runx/runx@sha256:c5bff1eb08b39334

The line at the top of this page pins the label git:20261017.16ba3f9, 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_a4j7uqaxf5qsul5d.svg)](https://markdownregistry.com/a/art_a4j7uqaxf5qsul5d)

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

Versions

The registry has recorded 11 versions of this file, between Jul 16, 2026 and Oct 17, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261017.16ba3f9 latest2026-10-17 16ba3f9 9,845 BB view · diff
git:20261015.18f531b2026-10-15 18f531b 9,867 BB view · diff
git:20261015.d0ec6af2026-10-15 d0ec6af 9,838 BB view · diff
git:20261013.1e98ddd2026-10-13 1e98ddd 9,862 BB view · diff
git:20261013.8fa82082026-10-13 8fa8208 9,749 BB view · diff
git:20261013.61754c92026-10-13 61754c9 9,780 BB view · diff
git:20260909.15accb02026-09-09 15accb0 9,325 BB view · diff
git:20260822.a6dcd1e2026-08-22 a6dcd1e 9,329 BB view · diff
git:20260813.e9113262026-08-13 e911326 9,315 BB view · diff
git:20260723.6e5370b2026-07-23 6e5370b 9,331 BB view · diff
git:20260716.b2ae7b62026-07-16 b2ae7b6 9,506 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No curl or wget piped into a shell (matched: curl -fsSL https://runx.ai/install | sh)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9845 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 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

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

runxhq/runx · 105 stars · license Apache-2.0 · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_a4j7uqaxf5qsul5d
GET https://markdownregistry.com/api/v1/resolve?ref=runxhq/runx/runx
GET https://markdownregistry.com/api/v1/blob/c5bff1eb08b39334c92db3bcf1b482458672f027742ae83b10eebee5ef505485

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 runxhq/runx

AGENTS.md AGENTS.md file
runxhq/runx · AGENTS.md
git:20261017.e17909c · audit A · 105 stars
CLAUDE.md CLAUDE.md file
runxhq/runx · CLAUDE.md
git:20260908.0ff743d · audit A · 105 stars
hello-world SKILL.md skill
runxhq/runx · examples/hello-world/SKILL.md · Echo a first runx message through a checked-in process tool script.
git:20261008.1a28e75 · audit B · 105 stars
loop-orchestration SKILL.md skill
runxhq/runx · examples/loop-orchestration/SKILL.md · Reference loop-orchestration example; a local loop host chains governed runx runs through receipts, budgets, context…
git:20261013.a7dee96 · audit A · 105 stars
loop-operator-context SKILL.md skill
runxhq/runx · examples/loop-orchestration/context/loop-operator/SKILL.md · Advisory operating context for the loop-orchestration example.
git:20261008.1a28e75 · audit A · 105 stars
managed-agent-intake SKILL.md skill
runxhq/runx · examples/managed-agent/SKILL.md · Managed-agent front example; a governed agent step that drafts a triage summary.
git:20261022.b44db26 · audit A · 105 stars
uncovered SKILL.md skill
runxhq/runx · fixtures/doctor/skill-fixture-missing/workspace/skills/uncovered/SKILL.md · Doctor fixture with an execution profile and no harness proof.
git:20260723.6e5370b · audit B · 105 stars
catalog-in-manual SKILL.md skill
runxhq/runx · fixtures/doctor/skill-frontmatter-invalid/workspace/skills/catalog-in-manual/SKILL.md · Doctor fixture whose frontmatter carries catalog metadata.
git:20261008.1a28e75 · audit A · 105 stars
original-name SKILL.md skill
runxhq/runx · fixtures/doctor/skill-frontmatter-invalid/workspace/skills/renamed-directory/SKILL.md · Doctor fixture whose name no longer matches its directory.
git:20261008.1a28e75 · audit B · 105 stars
records SKILL.md skill
runxhq/runx · fixtures/journeys/hosted-records/skills/records/SKILL.md · List the records a hosted fixture connector holds.
git:20261018.f7b2bbc · audit B · 105 stars
reviewer-boundary SKILL.md skill
runxhq/runx · fixtures/skills/agent-task/SKILL.md · Test-only explicit agent-task boundary fixture.
git:20260723.6e5370b · audit B · 105 stars
echo SKILL.md skill
runxhq/runx · fixtures/skills/echo/SKILL.md · Echo a message through a process tool.
git:20261008.1a28e75 · audit B · 105 stars

Every file in runxhq/runx

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