diagnose-skill-run SKILL.md skillA

diagnose-skill-run 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/diagnose-skill-run@git:20261023.420f372

Pins git:20261023.420f372 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
runxhq/runx
Path
skills/diagnose-skill-run/SKILL.md
Versions recorded
4
Latest version
git:20261023.420f372, committed Oct 23, 2026
First version recorded
Aug 8, 2026
Size
5,083 bytes
Repository stars
104
License
Apache-2.0

Diagnose a failed or suspicious Runx skill execution from receipts and harness evidence, then propose the smallest bounded improvement without replaying the failed operation.

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

# Diagnose Skill Run

Diagnose what went wrong in a skill or graph execution and propose the
smallest change that fixes it.

Resolve `receipt_id` through the native `receipt-query read` runner, then combine its
redacted receipt detail with the supplied failure summary or harness output.
The native detail is authoritative for status, verification, authority, acts,
decisions, criterion status, references, and seal posture. It deliberately
excludes hydrated step output, stdout, stderr, credential values, context
bodies, and local paths; those details must come from supplied bounded failure
evidence when they are necessary.

Distinguish root cause from symptoms. A graph may report failure at step 4,
but the root cause may be bad output from step 2 that propagated through
context passing. Trace data flow backward through context edges to find
where the problem originated.

Classify the failure:

- **Input error** — required input missing or malformed. Fix: input
  validation or input resolution.
- **Scope denial** — step requested scopes outside the graph grant.
  Fix: scope declarations or grant configuration.
- **Tool failure** — CLI tool or adapter returned an error. Fix: tool
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add runxhq/runx/diagnose-skill-run@sha256:7a2752e060658191

The line at the top of this page pins the label git:20261023.420f372, 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_jejutyt5najdh43p.svg)](https://markdownregistry.com/a/art_jejutyt5najdh43p)

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

Versions

The registry has recorded 4 versions of this file, between Aug 8, 2026 and Oct 23, 2026, about one every 25 days.

versioncommittedcommitsizeaudit
git:20261023.420f372 latest2026-10-23 420f372 5,083 BA view · diff
git:20261011.22b0cae2026-10-11 22b0cae 5,177 BA view · diff
git:20261008.1a28e752026-10-08 1a28e75 5,159 BA view · diff
git:20260808.8b7af2a2026-08-08 8b7af2a 5,187 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 (5083 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

runxhq/runx · 104 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jejutyt5najdh43p
GET https://markdownregistry.com/api/v1/resolve?ref=runxhq/runx/diagnose-skill-run
GET https://markdownregistry.com/api/v1/blob/7a2752e060658191df39fabfab01543441f270c932bb4c28ca209cebc102e087

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:20261105.fdab958 · audit A · 104 stars
CLAUDE.md CLAUDE.md file
runxhq/runx · CLAUDE.md
git:20260908.0ff743d · audit A · 104 stars
runx SKILL.md skill
runxhq/runx · SKILL.md · Governed runtime for agent skills: discover and install portable skills, run bounded skill graphs with explicit…
git:20261105.fdab958 · audit B · 104 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 · 104 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 · 104 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 · 104 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 · 104 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 · 104 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 · 104 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 · 104 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 · 104 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 · 104 stars

Every file in runxhq/runx

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