marathon SKILL.md skillA

marathon from bjcoombs/ai-native-toolkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bjcoombs/ai-native-toolkit/marathon@git:20261008.d56b7ee

Pins git:20261008.d56b7ee in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bjcoombs/ai-native-toolkit
Path
skills/marathon/SKILL.md
Versions recorded
8
Latest version
git:20261008.d56b7ee, committed Oct 8, 2026
First version recorded
Sep 14, 2026
Size
56,564 bytes
Repository stars
32
License
Apache-2.0

Run a list of work units to completion with an Agent Team: derive a dependency DAG and hot-file map, spawn one ephemeral teammate per unit (or combined group), drive each PR through pr-review-merge, smart-merge in waves, recover from crashes, and run a retrospective. Source-agnostic — the caller supplies a work-source adapter. A library skill invoked BY the /tm and /issues commands, not run directly by a user (it needs a caller-supplied adapter). TRIGGER when a command needs autonomous…

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

<!-- floor:cold-verify-completion -->

# Marathon Engine

Source-agnostic team orchestration. The caller supplies a **work-source adapter**; this
skill owns DAG analysis, hot-file combining, team lifecycle, waves, crash recovery, and
the retrospective. It uses the `pr-review-merge` skill for every PR.

## Work-Source Adapter Contract

The calling command MUST fill these four operations before invoking this skill:

| Operation | What it returns / does |
|-----------|------------------------|
| **enumerate** | A list of work units, each `{id, title, requirements, dependencies[], complexity}` |
| **mark in-progress** | Marks one unit started in the source of truth |
| **close on merge** | How a merged PR closes the unit (e.g. a label, a status set, or PR `Closes #N`) |
| **branch / worktree** | The branch name and `worktree/<...>` path convention for a unit |

The caller also passes Marathon Configuration values (base branch, required approvals,
bot-reviewer rules, CI patterns) read from the project's CLAUDE.md.

## Phase 0: Capability Detection

```bash
# Agent Teams
echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
```

Set `$TEAMS_AVAILABLE` (`true` if result is `"1"`).
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bjcoombs/ai-native-toolkit/marathon@sha256:d2594ccd389adc0b

The line at the top of this page pins the label git:20261008.d56b7ee, 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_ewo7ddzcl4mmpzbt.svg)](https://markdownregistry.com/a/art_ewo7ddzcl4mmpzbt)

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

Versions

The registry has recorded 8 versions of this file, between Sep 14, 2026 and Oct 8, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261008.d56b7ee latest2026-10-08 d56b7ee 56,564 BA view · diff
git:20261007.93fbd8e2026-10-07 93fbd8e 56,556 BA view · diff
git:20261007.747a8f82026-10-07 747a8f8 56,095 BA view · diff
git:20260914.b418bdd2026-09-14 b418bdd 51,221 BA view · diff
git:20260914.0a38eea2026-09-14 0a38eea 51,176 BA view · diff
git:20260914.efd23c72026-09-14 efd23c7 49,362 BA view · diff
git:20260914.074c29b2026-09-14 074c29b 47,606 BA view · diff
git:20260914.56f00082026-09-14 56f0008 47,242 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 (56564 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

bjcoombs/ai-native-toolkit · 32 stars · license Apache-2.0 · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ewo7ddzcl4mmpzbt
GET https://markdownregistry.com/api/v1/resolve?ref=bjcoombs/ai-native-toolkit/marathon
GET https://markdownregistry.com/api/v1/blob/d2594ccd389adc0bd71d18d1af1f883bfdfc9d0ed2bed6d8cd25f9de25c355ad

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 bjcoombs/ai-native-toolkit

CLAUDE.md CLAUDE.md file
bjcoombs/ai-native-toolkit · CLAUDE.md
git:20261011.ef225e2 · audit A · 32 stars
6hats SKILL.md skill
bjcoombs/ai-native-toolkit · skills/6hats/SKILL.md · Six Thinking Hats Analysis
git:20261008.d56b7ee · audit A · 32 stars
ab-equivalence SKILL.md skill
bjcoombs/ai-native-toolkit · skills/ab-equivalence/SKILL.md · Compare two versions of an LLM-directed document - an original (teacher) and a candidate (student) - across a transfer…
git:20260625.d42d180 · audit A · 32 stars
assess-findings SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess-findings/SKILL.md · Renders the /assess report from the deterministic run-context.json and the layer scorecard - the scorecard, the…
git:20261011.6157131 · audit A · 32 stars
assess-pr SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess-pr/SKILL.md · The /assess end-of-run offers - open a PR with the report, track the Top 3 Actions in the user's issue tracker, freeze…
git:20260919.492572b · audit A · 32 stars
assess SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/SKILL.md · Assess a codebase's readiness for AI agent contributors using the layered contract model, and generate a complexity…
git:20261011.6157131 · audit A · 32 stars
typo SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/claude_config_plugin/extra-skills/typo/SKILL.md · Loaded through the manifest's skills path.
git:20261008.11a01e8 · audit B · 32 stars
clean SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/claude_config_plugin/skills/clean/SKILL.md · A skill whose every field is documented.
git:20261008.11a01e8 · audit B · 32 stars
go-conventions SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/lean_with_skills/.claude/skills/go-conventions/SKILL.md · Go conventions for this repo. TRIGGER when editing any *.go file or Connect-Go handlers.
git:20260529.d38243f · audit A · 32 stars
java-conventions SKILL.md skill
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/lean_with_skills/.claude/skills/java-conventions/SKILL.md · Java conventions for this repo. TRIGGER when editing any *.java file, JUnit tests, or Maven modules.
git:20260529.d38243f · audit A · 32 stars
CLAUDE.md@skills/assess/tests/fixtures/lean_with_skills CLAUDE.md file
bjcoombs/ai-native-toolkit · skills/assess/tests/fixtures/lean_with_skills/CLAUDE.md
git:20260529.d38243f · audit A · 32 stars
deslop SKILL.md skill
bjcoombs/ai-native-toolkit · skills/deslop/SKILL.md · Detect and remove the telltale signs of AI-generated 'slop' from any written text - articles, reports, emails, essays…
git:20260920.ef322b2 · audit A · 32 stars

Every file in bjcoombs/ai-native-toolkit

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