loop-runner SKILL.md skillA

loop-runner from frankxai/claude-skills-library is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add frankxai/claude-skills-library/loop-runner@git:20260703.f049bcc

Pins git:20260703.f049bcc in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
frankxai/claude-skills-library
Path
free-skills/loop-runner/SKILL.md
Versions recorded
1
Latest version
git:20260703.f049bcc, committed Jul 3, 2026
Size
8,163 bytes
Repository stars
47
License
MIT

Execute exactly one disciplined iteration of a designed loop from .loop/<name>/ (LOOP.md charter + state.json + journal.md). Use when asked to "run the loop", "run one iteration of <loop>", "continue the <name> loop", or when invoked on a cadence (cron, /loop, while-loop) against a loop directory. Works identically under Claude Code, Codex, Gemini CLI, or any coding agent — state lives in files, not in this conversation.

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

# Loop Runner

You are one iteration of a durable loop. You start cold, you finish clean, and everything you learn goes into files — the next iteration (possibly a different agent, possibly you tomorrow) knows only what the loop directory says. Run **exactly one unit**; resist finishing "just one more".

## The iteration protocol

Execute in order. Do not skip, reorder, or batch steps.

### 0 · Load

Read, in this order: `.loop/<name>/LOOP.md` (the whole charter), `.loop/<name>/signs.md`
(every line is a binding rule earned from a past failure — treat them like
Guardrails), `.loop/<name>/state.json`, the **last 3 entries** of
`.loop/<name>/journal.md`, and `.loop/<name>/backlog.md` if the archetype uses one.
Do not read the full journal — old entries are archive, not context.

### 1 · Gate

Refuse to run (exit with one journal line explaining why) if ANY of:

- `.loop/STOP` or `.loop/<name>/STOP` exists — the operator's kill switch. Never
  delete a STOP file.
- `status` is `paused`, `stalled`, `blocked`, `done`, or `retired` — only an operator
  or the orchestrator changes those.
- `iteration >= budget.max_iterations`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add frankxai/claude-skills-library/loop-runner@sha256:967774c1807c12cc

The line at the top of this page pins the label git:20260703.f049bcc, 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_dlfbis34xmzl3agx.svg)](https://markdownregistry.com/a/art_dlfbis34xmzl3agx)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 3, 2026.

versioncommittedcommitsizeaudit
git:20260703.f049bcc latest2026-07-03 f049bcc 8,163 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 (8163 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

frankxai/claude-skills-library · 47 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dlfbis34xmzl3agx
GET https://markdownregistry.com/api/v1/resolve?ref=frankxai/claude-skills-library/loop-runner
GET https://markdownregistry.com/api/v1/blob/967774c1807c12ccfca35e9981d394bfc11c438fc32942d6b4a1ebe0c5b95a43

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 frankxai/claude-skills-library

excellence-review SKILL.md skill
frankxai/claude-skills-library · .grok/skills/excellence-review/SKILL.md · Mandatory excellence gates for Grok+ACOS. verification-loop, santa-method, gstack-qa, plan-reviews, repo-mastery, cso…
git:20260820.5d4ee7a · audit A · 47 stars
harness-integration SKILL.md skill
frankxai/claude-skills-library · .grok/skills/harness-integration/SKILL.md · ACOS Grok bridge. SessionStart loads repo-mastery + excellence gates. PreToolUse enforces rules read + suggests harness…
git:20261014.6571e8d · audit A · 47 stars
multi-harness-orchestrator SKILL.md skill
frankxai/claude-skills-library · .grok/skills/multi-harness-orchestrator/SKILL.md · Automatically detect tasks suited for delegation to other agent harnesses (Claude Code as canonical, agy/antigravity…
git:20260820.5d4ee7a · audit A · 47 stars
repo-mastery SKILL.md skill
frankxai/claude-skills-library · .grok/skills/repo-mastery/SKILL.md · Master ACOS, FrankX, Starlight-Intelligence-System, arcanea, claude-code-config and full starlight/repos ecosystem…
git:20261014.6571e8d · audit A · 47 stars
AGENTS.md AGENTS.md file
frankxai/claude-skills-library · AGENTS.md
git:20261014.6571e8d · audit F · 47 stars
agent-harness-construction SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/agent-harness-construction/SKILL.md · Shape an agent's tools, observations, and recovery without adding a second coordinator. Use when defining a tool, a…
git:20261010.682b2ce · audit A · 47 stars
context-budget SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/context-budget/SKILL.md · Count what a session loads before adding another skill or MCP server. Use when the default prompt is heavy, a new…
git:20261010.682b2ce · audit A · 47 stars
cost-aware-llm-pipeline SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/cost-aware-llm-pipeline/SKILL.md · Pick the smallest model that can finish the task, and record the class of work. Use when routing a search, a multi-file…
git:20261010.682b2ce · audit A · 47 stars
santa-method SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/santa-method/SKILL.md · Send a finished change to two reviewers who did not write it, using one rubric, and stop after three rounds. Use before…
git:20261011.854bb48 · audit A · 47 stars
search-first SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/search-first/SKILL.md · Look for an existing repo, package, and skill before writing a new one. Use when starting a feature, adding a…
git:20261010.682b2ce · audit A · 47 stars
security-review SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/security-review/SKILL.md · Scan a port or a diff before it lands, and apply the narrow deny list for this machine. Use before copying upstream…
git:20261010.682b2ce · audit A · 47 stars
strategic-compact SKILL.md skill
frankxai/claude-skills-library · absorbed/harness/strategic-compact/SKILL.md · Write what worked, what failed, and what is still open to a file, then compact at a phase boundary. Use when a long…
git:20261010.682b2ce · audit A · 47 stars

Every file in frankxai/claude-skills-library

Other files named loop-runner

loop-runner SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.opencode/skills/loop-runner/SKILL.md · Execute and manage loop engineering primitives (init, run, status, audit) from an AI coding
v1.1 · audit A · 19 stars
loop-runner SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/loop-runner/SKILL.md · Execute and manage loop engineering primitives (init, run, status, audit) from an AI coding
v1.1 · audit A · 19 stars

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