repo-sync SKILL.md skillA

repo-sync from bluechonk/modelmux is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bluechonk/modelmux/repo-sync@git:20261105.29cf971

Pins git:20261105.29cf971 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/repo-sync/SKILL.md
Versions recorded
8
Latest version
git:20261105.29cf971, committed Nov 5, 2026
First version recorded
Oct 29, 2026
Size
17,130 bytes
Repository stars
11
License
MIT

modelmux 仓库的收尾与同步流程:把一轮代码改动同步到 docs 文档、规划进度与 commit 历史,并在需要上线时走完分支 → PR → CI → squash merge → 删分支的闭环。用户说「收尾」「同步文档」「更新 plan/进度」「做好 commit/PR/merge」「整理提交历史」「结项」时必须使用本技能,即使没有明确点名。.

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

# repo-sync —— 仓库收尾与同步

本技能覆盖 modelmux 仓库的**一轮工作如何收尾**:代码改完 ≠ 完成。必须同步 docs、
规划与 commit 历史;需要推送到远端时再走 PR 闭环。规则源头是根 `AGENTS.md` 与
[docs/AGENTS.md](../../../docs/AGENTS.md),本技能是**可执行的操作手册**;冲突时以前两者为准。

## 0. 事实基线(动手前必须先跑)

```bash
git status --short            # 工作树状态
git branch --show-current     # 当前分支(大改造禁止在 main 上)
git fetch --prune             # 先 prune,否则已删的远端分支仍会出现在 branch -a
git log --oneline -5          # 最近历史与提交风格
git rev-list --left-right --count main...origin/main   # 本地与远端差多少
```

判定「大改造」(必须开分支,命中任一即算):

- 改动跨越 `packages/` 下两个及以上包;
- 涉及目录结构、包边界、`workspaces`、`tsconfig` references 的调整;
- 涉及契约(`docs/CONTRACT-TS.md`)、存储落点、池架构的规则修改;
- 对外 API 形态或模型 id 形态变更;
- 预计改动超过 20 个文件。

分支名:`feat/<模块>` / `fix/<模块>` / `refactor/<模块>`,从**最新 main** 创建。

**节奏**:大改造立即开分支并走完整 PR 流程;小改动(单包/单文件/文档/注释/UI 微调)
先在 `main` 本地攒 commit,攒够一批或需要让改动生效时再一次性走 PR —— 不要一个 commit
开一个 PR。

## 1. 文档同步矩阵(代码改了哪些地方 → 哪些文档必须跟着改)

文档分层、事实归属与写作规则以 [docs/AGENTS.md](../../../docs/AGENTS.md) 为准;本表只列
代码改动对应的文档落点。

| 改动落点 | 必须同步的文档 |
| --- | --- |
| 契约 / CLI 形态 / 模块边界 / 分层 | `docs/CONTRACT-TS.md`、根 `AGENTS.md` 的「代码约定」 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bluechonk/modelmux/repo-sync@sha256:d857e27d1995b080

The line at the top of this page pins the label git:20261105.29cf971, 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_f4hld6hsesu6gtik.svg)](https://markdownregistry.com/a/art_f4hld6hsesu6gtik)

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

Versions

The registry has recorded 8 versions of this file, between Oct 29, 2026 and Nov 5, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261105.29cf971 latest2026-11-05 29cf971 17,130 BA view · diff
git:20261104.42d60e22026-11-04 42d60e2 15,414 BA view · diff
git:20261104.ee4272d2026-11-04 ee4272d 15,355 BA view · diff
git:20261102.7c0d61e2026-11-02 7c0d61e 15,360 BA view · diff
git:20261102.d2bbb082026-11-02 d2bbb08 13,609 BA view · diff
git:20261101.c4bb7112026-11-01 c4bb711 13,420 BA view · diff
git:20261029.469f3de2026-10-29 469f3de 13,324 BA view · diff
git:20261029.df352b82026-10-29 df352b8 13,014 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 (17130 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

bluechonk/modelmux · 11 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_f4hld6hsesu6gtik
GET https://markdownregistry.com/api/v1/resolve?ref=bluechonk/modelmux/repo-sync
GET https://markdownregistry.com/api/v1/blob/d857e27d1995b0807e1edb36500ecf9d79b93c19c3bbbd359e8f6ca06e50a0dd

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

claude-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/claude-mx-test/SKILL.md · 用 Claude Code 对 modelmux(mx)网关做端到端测试(Anthropic Messages 协议,/v1/messages + count_tokens)。适用于:用 claude 测 mx、claude code…
git:20261107.0bf381d · audit B · 11 stars
codex-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/codex-mx-test/SKILL.md · 用 Codex CLI 对 modelmux(mx)网关做端到端测试(OpenAI Responses 协议,/v1/responses)。适用于:用 codex 测 mx、codex 接入 modelmux、验证…
git:20261107.0bf381d · audit B · 11 stars
dsh-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/dsh-mx-test/SKILL.md · 用 dsh(DeepSeek Harness)ACP 协议对 modelmux(mx)网关做端到端模型测试。适用于:用 dsh 测 mx、dsh 接入 modelmux、网关端到端验收、换 harness 复测模型、dsh…
git:20261106.f07736d · audit B · 11 stars
log-triage SKILL.md skill
bluechonk/modelmux · .agents/skills/log-triage/SKILL.md · modelmux 的日志排查与故障分诊流程。只要用户问“为什么这么慢 / 为什么失败 / 超时 / 卡住 / 网关挂了 / 日志在哪 / 怎么排查 / 看下日志”,或提到 request id、慢请求、502/503、stale…
git:20261106.f07736d · audit A · 11 stars
mx-cli SKILL.md skill
bluechonk/modelmux · .agents/skills/mx-cli/SKILL.md · modelmux 的 mx CLI 使用手册。用户要运行/查询/配置 mx(启动、重启、状态、模型、登录、账号池、额度、日志、Web 控制台、path),或不确定动词与渠道参数的顺序、该用 mx model list 还是 mx…
git:20261107.bc11d30 · audit B · 11 stars
zcode-session-archaeology SKILL.md skill
bluechonk/modelmux · .agents/skills/zcode-session-archaeology/SKILL.md · 按 session id 或项目路径还原另一个 ZCode 会话做了什么(模型、轮次、工具调用、错误、最终结论、产物),用于多会话并行改同一个项目时的对齐、排查与收尾。当用户提到「另一个会话」「session_xxx /…
git:20261025.1f96581 · audit A · 11 stars
AGENTS.md AGENTS.md file
bluechonk/modelmux · AGENTS.md
git:20261107.bd0e3d9 · audit A · 11 stars
AGENTS.md@docs AGENTS.md file
bluechonk/modelmux · docs/AGENTS.md
git:20261105.36a6b70 · audit A · 11 stars
AGENTS.md@packages/core/channels/catpaw AGENTS.md file
bluechonk/modelmux · packages/core/channels/catpaw/AGENTS.md
git:20261019.f7f08e1 · audit A · 11 stars

Every file in bluechonk/modelmux

Other files named repo-sync

repo-sync SKILL.md skill
davidondrej/skills · skills/ops-and-setup/repo-sync/SKILL.md · Manage automatic Git syncing on macOS with repo-sync. Use only when the user explicitly invokes /repo-sync.
git:20260913.aa95c27 · audit A · 4,263 stars

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