autorun-maintainer SKILL.md skillA

autorun-maintainer from ahundt/autorun is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ahundt/autorun/autorun-maintainer@git:20260816.82c264e

Pins git:20260816.82c264e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ahundt/autorun
Path
.agents/skills/autorun-maintainer/SKILL.md
Versions recorded
3
Latest version
git:20260816.82c264e, committed Aug 16, 2026
First version recorded
Aug 5, 2026
Size
21,409 bytes
Repository stars
12
License
a license file GitHub does not identify

Expertise in maintaining, debugging, and deploying the autorun hook system across Claude Code, Codex CLI, Gemini-family CLIs, Google Antigravity, Qwen Code, ForgeCode, custom harnesses, and desktop app integrations. Use when the user asks to "fix hooks", "deploy autorun", "debug hook errors", "update autorun version", or when troubleshooting "invisible failures" where safety guards appear inactive, piped commands are blocked, or work appears to have "reverted" after a session.

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

# Autorun Maintainer Skill: The Definitive Guide

<purpose>

You are a Senior QA and Release Engineer specialized in the autorun hook ecosystem. Your mission is to eliminate the "Zombie State" (code edited but hooks stale) and resolve "Invisible Failures" (UI masking the true cause) without breaking active sessions on other harnesses.

---

## 1. The Debugging Philosophy: "Trust No UI"

Claude Code's "hook error" is a generic mask. **Never trust the UI.** You MUST follow the **Diagnostic Hierarchy** to find the root cause:

### Step 1: Plumbing Check (`~/.autorun/hook_entry_debug.log`)
*   **Binary Selection**: Verify `get_autorun_bin()` found the correct venv.
*   **Exit Codes**: Did the CLI exit with `0` (Allow/Ask) or `2` (Blocking Workaround)?
*   **Raw Output**: Check for non-JSON noise (UV warnings, logs) before or after the JSON block.
*   **Validation**: Did `extract_json()` isolate exactly one valid block via `json.loads`?

### Step 2: Logic Check (`~/.autorun/daemon.log`)
*   **FullPayload**: Check `FullPayload`. Are expected keys present (e.g., `_pid`, `_cwd`)?
*   **Timing**: Check `DAEMON PROCESSING END`. If duration > 9000ms, it will trigger a Claude timeout.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ahundt/autorun/autorun-maintainer@sha256:42e4d2952d0d6159

The line at the top of this page pins the label git:20260816.82c264e, 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_xczzzyw5d3sdjd75.svg)](https://markdownregistry.com/a/art_xczzzyw5d3sdjd75)

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

Versions

The registry has recorded 3 versions of this file, between Aug 5, 2026 and Aug 16, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260816.82c264e latest2026-08-16 82c264e 21,409 BA view · diff
git:20260815.2807be52026-08-15 2807be5 21,306 BA view · diff
git:20260805.9a747022026-08-05 9a74702 21,075 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 (21409 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

ahundt/autorun · 12 stars · license a license file GitHub does not identify · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xczzzyw5d3sdjd75
GET https://markdownregistry.com/api/v1/resolve?ref=ahundt/autorun/autorun-maintainer
GET https://markdownregistry.com/api/v1/blob/42e4d2952d0d6159127878f26af7f279301f65ff5fb0a344d551868fa0792fa2

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 ahundt/autorun

AGENTS.md AGENTS.md file
ahundt/autorun · AGENTS.md
git:20261014.f772782 · audit A · 12 stars
CLAUDE.md CLAUDE.md file
ahundt/autorun · CLAUDE.md
git:20260727.9b75cd9 · audit B · 12 stars
ar SKILL.md skill
ahundt/autorun · plugins/autorun/.codex-plugin/skills/ar/SKILL.md · autorun control commands, stated as prose after $ar: status; allow/justify/find file-creation policy…
git:20260815.2807be5 · audit A · 12 stars
AGENTS.md@plugins/autorun AGENTS.md file
ahundt/autorun · plugins/autorun/AGENTS.md
git:20260818.85c8a47 · audit A · 12 stars
CLAUDE.md@plugins/autorun CLAUDE.md file
ahundt/autorun · plugins/autorun/CLAUDE.md
git:20260805.124c64e · audit B · 12 stars
ai-skill-builder SKILL.md skill
ahundt/autorun · plugins/autorun/skills/ai-skill-builder/SKILL.md · Guides creation, audit, and improvement of portable Agent Skills using the shared
v1.3.0 · audit A · 12 stars
cache SKILL.md skill
ahundt/autorun · plugins/autorun/skills/cache/SKILL.md · Use this skill when the user asks to "enable cache protection", "block on cache miss", "avoid cache expiration cost"…
git:20260816.82c264e · audit A · 12 stars
cli-demo-recorder SKILL.md skill
ahundt/autorun · plugins/autorun/skills/cli-demo-recorder/SKILL.md · Create demo videos for CLI and TUI tools. Use when user asks to "record a demo",
v5.1.0 · audit A · 12 stars
commit SKILL.md skill
ahundt/autorun · plugins/autorun/skills/commit/SKILL.md · Use before writing any git commit message or reviewing one, and when the user asks for "commit requirements", "commit…
git:20260816.da968ed · audit A · 12 stars
function-signature-and-parameter-guidance SKILL.md skill
ahundt/autorun · plugins/autorun/skills/function-signature-and-parameter-guidance/SKILL.md · Design and review caller-facing names and contracts: functions, tools, commands, CLI flags, parameters, config keys…
git:20260816.05745f8 · audit A · 12 stars
marketplace-test SKILL.md skill
ahundt/autorun · plugins/autorun/skills/marketplace-test/SKILL.md · Use when the user asks to "test the marketplace plugins", "run marketplace tests", "check every installed plugin", or…
git:20260816.640f782 · audit A · 12 stars
mermaid-diagrams SKILL.md skill
ahundt/autorun · plugins/autorun/skills/mermaid-diagrams/SKILL.md · Render Mermaid diagrams to SVG using beautiful-mermaid and bun. Use when the user asks to "render mermaid", "generate…
git:20260816.82c264e · audit B · 12 stars

Every file in ahundt/autorun

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