sync-tools
GitHub同步源码到 Codex、OpenCode 和 Pi 等平台的插件技能文件，生成分发副本并检测漂移。包含验证工具的复制与一致性检查，确保各宿主环境读取的技能文件保持字节级一致。
Trigger Scenarios
Install
npx skills add doodledood/manifest-dev --skill sync-tools -g -y
SKILL.md
Frontmatter
{
"name": "sync-tools",
"metadata": {
"internal": true
},
"description": "Regenerate the Codex distribution copy of the plugin skills, and the copies of the shipped verify tool, and check them for drift. Run after changing anything under claude-plugins\/*\/skills. OpenCode and Pi read the source tree directly and need no sync.",
"user-invocable": true
}
/sync-tools — distribution sync
Every host reads the same skill files. The Claude Code plugins under claude-plugins/ are the source; OpenCode (dist/opencode/plugin/index.js) and Pi (repo-root package.json, pi.skills) point straight at claude-plugins/*/skills. Only Codex needs a copy, because it installs a plugin into its own cache, and that copy is generated:
python3 scripts/sync_dist.py # regenerate dist/codex/plugins/*/skills byte-identically from source
python3 scripts/sync_dist.py --check # exit 1 on any drift (tests/test_dist_skill_references.py runs this)
The same commands copy the verification tool setup-project ships (setup-project/references/harness/verify and verify.mts) to scripts/ and into the eval scaffolds that embed it, and check those copies too.
Run the first command after any change under claude-plugins/*/skills, then commit the regenerated tree with the change. There is no per-host rewrite: shipped skill text names no host primitive (tests/test_skill_frontmatter.py enforces that), so a copy is a copy.
Hand-maintained packaging files
These are not generated. Edit them when what they describe changes:
| File | What it carries |
|---|---|
dist/codex/plugins/manifest-dev/.codex-plugin/plugin.json, dist/codex/plugins/manifest-dev-tools/.codex-plugin/plugin.json |
Codex plugin manifests; version must equal the source plugin's .claude-plugin/plugin.json version |
.agents/plugins/marketplace.json |
Codex marketplace registry pointing at the two plugin directories |
dist/opencode/plugin/index.js, dist/opencode/plugin/package.json |
OpenCode plugin entry (registers the source skill dirs and slash-command wrappers); version tracks manifest-dev's |
dist/opencode/AGENTS.md |
OpenCode instructions file the plugin registers |
dist/pi/prompts/*.md |
Pi prompt-template aliases (/do, /auto, /babysit-pr) |
dist/codex/README.md, dist/opencode/README.md, dist/pi/README.md |
Per-host install and update instructions |
Version bumps follow the repo's Versioning rules; this skill does not bump anything.
Version History
-
5d3a066
Current 2026-10-19 18:04
新增 setup-project 验证工具的分发同步逻辑，支持 TypeScript 版本的 verify 工具同步及校验。
-
3fc997a
2026-09-22 22:24
重构为宿主中立技能文本，将委托作为技能处理，分发系统直接读取源文件，不再针对特定主机重写。
- 2ac487e 2026-08-20 08:55
