log-triage SKILL.md skillA
log-triage from bluechonk/modelmux is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add bluechonk/modelmux/log-triage@git:20261106.f07736dPins git:20261106.f07736d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- bluechonk/modelmux
- Path
.agents/skills/log-triage/SKILL.md- Versions recorded
- 7
- Latest version
- git:20261106.f07736d, committed Nov 6, 2026
- First version recorded
- Oct 24, 2026
- Size
- 8,978 bytes
- Repository stars
- 11
- License
- MIT
modelmux 的日志排查与故障分诊流程。只要用户问“为什么这么慢 / 为什么失败 / 超时 / 卡住 / 网关挂了 / 日志在哪 / 怎么排查 / 看下日志”，或提到 request id、慢请求、502/503、stale build、upstream_timeout、tool loop 卡住、日志文件，就立即使用本技能。日志默认在 ~/.modelmux/logs/ 分层目录，落点与字段规范见 docs/LOGGING.md。.
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
# modelmux 日志分诊 目标：给出**可核验**的结论 —— 请求走到哪一层、耗时落在哪一段、下一步做什么。 每条结论必须能对应到日志里的一行（以请求 id 关联），不靠推测。 日志的落点、字段与判定规则见 [`docs/LOGGING.md`](../../../docs/LOGGING.md)。本技能只讲**怎么查、怎么判**。 ## 0. 前置检查 ```bash mx status --json mx log --list ``` | 判定 | 处置 | | --- | --- | | `gateway.reachable=false` | 转 §3「网关不可用」 | | 顶层 `stale_build=true` | 运行的是旧代码：`npm run build && mx restart`，直到 `stale_build=false` | | 顶层 `log_dir` 与预期不一致 | 可能是有意设置的 `MODELMUX_HOME`；先确认这是不是当前实例的存储根，再继续 | 字段层级提醒：`reachable` / `occupied_by` 在 `gateway` 下；`stale_build` / `log_dir` 在顶层。 `mx status` 的**退出码恒为 0**（无论网关是否可达），脚本必须解析 JSON，不能看 exit code。 ## 1. 定位文件 | 目标 | 命令 | | --- | --- | | 失败请求 | `mx log --kind access --outcome failure --lines 50` | | 成功请求基线 | `mx log --kind access --outcome success --lines 20` | | 慢请求 | `mx log --list` 找到 `access/<date>/slow.log` 后直接读（CLI **没有** `--kind slow`；慢且失败的请求同时也在 `failure.log`） | | 错误上下文 | `mx log --kind error --lines 50` | | 启停与 worker 事件 | `mx log --kind lifecycle --lines 50` | | worker 原始输出 | `mx log --kind worker --lines 100` | | 某渠道 | `mx log catpaw --kind channel --lines 50`（`--kind channel` **必须**给 cid，否则报「日志不存在」） | | 指定日期 | `mx log --date YYYY-MM-DD --kind access --outcome failure` | …
Read the whole file at its exact version.
How to install
mdr add bluechonk/modelmux/log-triage@sha256:b00c08ba043f283bThe line at the top of this page pins the label git:20261106.f07736d, 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.
[](https://markdownregistry.com/a/art_a6wsqmxskxsm2fdp)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 7 versions of this file, between Oct 24, 2026 and Nov 6, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261106.f07736d latest | 2026-11-06 | f07736d | 8,978 B | A | view · diff |
| git:20261105.38debea | 2026-11-05 | 38debea | 8,984 B | A | view · diff |
| git:20261102.5bb6678 | 2026-11-02 | 5bb6678 | 8,938 B | A | view · diff |
| git:20261029.8cc58e9 | 2026-10-29 | 8cc58e9 | 8,944 B | A | view · diff |
| git:20261027.491c8ce | 2026-10-27 | 491c8ce | 8,512 B | A | view · diff |
| git:20261027.f12579a | 2026-10-27 | f12579a | 8,519 B | A | view · diff |
| git:20261024.fa57287 | 2026-10-24 | fa57287 | 7,983 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8978 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
bluechonk/modelmux · 11 stars · license MIT · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_a6wsqmxskxsm2fdp GET https://markdownregistry.com/api/v1/resolve?ref=bluechonk/modelmux/log-triage GET https://markdownregistry.com/api/v1/blob/b00c08ba043f283b978062496da200c8c4522169c6b819faf09716ed9dd2f4f8
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 bluechonk/modelmux
Every file in bluechonk/modelmux