这个 Skill 能做什么，适合哪些场景？
cmux-markdown 是 cmux（一款基于 Ghostty 的 macOS 终端）的一个技能，教你用 `cmux markdown open` 命令把 Markdown 文件在分屏面板中渲染显示。面板支持标题、代码块、表格、列表等富文本渲染，并通过文件监听实现实时刷新：每次写入磁盘都会触发重渲染，且能正确处理编辑器保存、`sed -i` 等原子替换。它特别适合让编码代理把计划或任务列表写入 .md 文件、在终端旁边实时展示。要使用它必须安装 cmux 应用本身。
- 用
cmux markdown open plan.md把 Markdown 文件在当前终端旁边以分屏面板打开 - 监听文件变化，每次写入后自动重渲染面板内容
- 将相对路径按调用方工作目录解析、展开
~，并在输出中返回绝对路径 - 支持标题（h1-h6）、等宽代码块、表格、嵌套列表、引用、链接、内联图片等富文本渲染，兼有浅色和深色模式
- 提供
--workspace、--surface、--window选项控制面板打开位置
- 运行编码代理（如 Claude Code）的开发者：让代理先把完整计划写入 .md 文件再打开，在终端旁实时跟踪任务进度
- 同时处理多个工作区的开发者：在分屏面板中查看文档或变更日志，边工作边读
- 运行会逐步更新笔记的其他进程的用户：笔记每次更新面板自动刷新，无需手动重开
- 想在项目中标准化这一流程的团队：按技能建议把指令写进 AGENTS.md
- 非 macOS 用户——cmux 是仅限 macOS 的原生应用，此技能完全依赖 cmux CLI
- 不需要 cmux 环境、只想在任意终端里渲染 Markdown 的用户——面板渲染是 cmux 应用内置功能
如何安装这个 Skill？
- 该 Skill 仅在已安装 cmux 桌面应用（macOS 专用）的机器上可用；Skill 文档本身未声明此前提，非 macOS 用户会直接失败。
- 仓库许可元数据为 NOASSERTION：实际为 GPL-3.0-or-later，但 web/ 等目录为 BUSL-1.1（生产使用需商业授权），企业使用前应核实适用范围。
- 面板渲染、live reload、watcher 行为均为文档声明，未经静态或执行验证；>100KB 文件重渲染可能造成 UI 卡顿。
- 文件被删除后面板不会在文件重新出现时自动重连，需手动关闭并重开面板。
- 发布方未经 FollowSkills 验证；无中文支持说明，文档与分发渠道均以海外为主。
- Shell / 命令行
- 本地文件系统
cmux (macOS app with the cmux CLI)
此技能位于 manaflow-ai/cmux 仓库的 skills/cmux-markdown/SKILL.md，属于一个包含 25 个技能的集合；README 未给出针对单个技能的安装命令。前置条件是安装 cmux 应用本体：
macOS（DMG / Homebrew）
brew tap manaflow-ai/cmux
brew install --cask cmux安装 cmux 后，把技能文件夹复制进你的 Agent Skills 目录（如 Claude Code 的 skills 目录），具体路径未在源文档中说明。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 把实施计划写到 plan.md 里，然后用 cmux 打开它，边执行边更新
- 创建一个带勾选框的任务列表文件并在 cmux 面板中展示，完成一项就更新文件
- 在 design.md 里写设计文档并打开预览，我改文件时希望面板自动刷新
技能的核心是先写文件、再打开：完整写好 .md 文件后执行打开命令，避免面板显示写了一半的内容；此后每次覆盖或追加写入都会触发重渲染。
cmux markdown open plan.md
cmux markdown open design.md --workspace workspace:2相对路径按当前工作目录解析，~ 会展开；也可用 --surface、--window 指定打开位置。若想让项目中的编码代理自动使用，可在 AGENTS.md 中加入技能提供的"Plan Display"指令段落。
这个 Skill 有哪些优点和局限？
- 实时重渲染：编辑器保存、sed -i 等原子替换都能正确处理，无需手动刷新
- 渲染覆盖面广：代码块、表格、嵌套列表、链接、内联图片，且支持浅色/深色模式
- 有深入的参考文档（commands.md、live-reload.md）覆盖命令语法和文件监听细节
- 提供了可直接粘贴到 AGENTS.md 的代理集成方案
- 硬依赖 cmux，只能在 macOS 上使用，且必须安装并运行 cmux 应用
- 仓库 License 字段为 NOASSERTION，虽然 README 说明主体为 GPL-3.0-or-later，单技能的使用条款需自行确认
- SKILL.md 未提供自动化测试或非 cmux 环境下的替代方案
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux Markdown 查看器 本页 | 52 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| Apple Bridges：Claude Code 的苹果原生应用桥接工具 | 53 · 谨慎使用 | ★ 48 | 1 个月前 | MIT |
| Gorden PPT 技能 | 61 · 推荐 | ★ 3.2k | 3 个月前 | NOASSERTION |
| LLM Wiki：AI 代理的第二大脑 | 58 · 推荐 | ★ 119 | 28 天前 | MIT |
| Book-to-Skill 图书技能转换器 | 57 · 谨慎使用 | ★ 34k | 6 天前 | MIT |
FollowSkills 如何评估这个 Skill？
该 Skill 仅由文档构成：指示 Agent 写入用户指定的 .md 文件并调用 `cmux markdown open` 在本机面板中只读渲染，无脚本执行、无网络访问、无凭据或敏感数据流，最小权限原则天然满足；文件路径解析（cwd、~ 展开并回显绝对路径）透明。扣分项：仓库元数据 License 标注为 NOASSERTION（实际为 GPL-3.0 + 部分目录 BUSL-1.1），且面板渲染行为、file watcher 实现均依赖不可静态审计的 cmux 应用二进制，发布方未经验证，无法达到 25 分。
文档自洽性好：命令语法、参数默认值、输出格式（OK surface=... / -- 字段）在 SKILL.md 与 references/commands.md 间一致；live-reload.md 详细说明了原子替换检测、500ms 重试、file unavailable 状态及 >100KB 文件的性能限制，属于较清晰的可诊断失败模式。扣分项：静态评审无法执行复现，无针对该 Skill 关键路径的提交测试证据（CI 测试均针对应用内部模块而非 Skill 文档所述行为），错误输出形态（非 OK 情况）未记载。
触发条件明确：description 精确界定了'打开 markdown 文件、终端旁富渲染、live reload'的场景，并给出 AGENTS.md 集成范例；边界（依赖 cmux 应用、macOS-only、只读面板、不重连已消失文件）大体可推断。扣分项：强依赖用户已安装 cmux 桌面应用，非 macOS 环境完全不可用，文档未在 Skill 层面声明此前提；无中文支持说明；核心功能依赖海外渠道分发的桌面应用，中国大陆可达性存在摩擦。
信息架构良好：SKILL.md 精炼 + 两个 deep-dive references 渐进披露，含命令参考、参数表、行为细节和性能限制，命名与参数（--workspace/--surface/--window）有明确默认值。扣分项：Skill 自身无版本号/变更记录，无独立许可声明（NOASSERTION），维护责任与更新路径仅在仓库层面间接可见，已知限制（如断开重连需手动关闭重开）散落在 references 中。
核心任务（写 .md → 面板富渲染 → live reload）路径清晰，比让 Agent 反复向终端输出计划更可用，且给出了 write-then-open 的正确顺序指导以避免半写状态。扣分项：静态评审无法验证渲染质量（表格、内联图片、深浅色模式）是否如文档所述；相对价值的证据主要是作者叙述，代表性输出未经独立验证，达到上限 7 分。
主要材料可审计：Skill 文档、命令输出样例、live-reload 实现细节（DispatchSource/O_EVTONLY、inode 重连）均为可读的原始声明，README 与 SECURITY.md 提供了仓库级佐证。扣分项：无任何第三方或 CI 对该 Skill 声称行为（markdown 渲染、watcher 行为）的执行验证，多源交叉验证薄弱，作者声明与事实缺乏区分机制。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →