用途：本技能解决 Diagram Design 的安装与“证明其能跑”的问题。Diagram Design 是插件/Agent 技能，不是 npm 或 pypi 包，没有 npm install、pip install，也没有二进制文件，装错路径技能就不会被加载。
前置条件：Python 3.10+（doctor 的必需检查项，低于 3.10 判 FAIL；但技能脚本在 3.9.6 上仍可运行）；仅在导出 PNG 时需要 Playwright + Chromium，命令为 pip install playwright && playwright install chromium；不需要 Node/npm（仅仓库自身 CI 使用）。没有构建步骤，没有 node_modules，产物为 Markdown、静态 HTML 和 3 个纯 Python 脚本。
主要能力与安装方式：按宿主选择一种。Claude Code 在聊天框执行 /plugin marketplace add cathrynlavery/diagram-design 与 /plugin install diagram-design@diagram-design，并建议在 /plugin → Marketplaces 中为 diagram-design 开启自动更新，再按提示执行 /reload-plugins。Codex 在终端执行 codex plugin marketplace add cathrynlavery/diagram-design 和 codex plugin add diagram-design@diagram-design，可用 codex plugin marketplace upgrade diagram-design 立即取新版。Factory Droid 使用 droid plugin marketplace add https://github.com/cathrynlavery/diagram-design 和 droid plugin install diagram-design@diagram-design --scope user，更新用 droid plugin marketplace update 与 droid plugin update。Pi 使用 pi install https://github.com/cathrynlavery/diagram-design，更新需手动 pi update --extensions，会话内 /reload；Pi 还会从 prompts/ 加载 /export-diagram、/import-mermaid、/profile、/doctor。Kiro 导入子目录 URL https://github.com/cathrynlavery/diagram-design/tree/main/skills/diagram-design，复制到 .kiro/skills/ 或 ~/.kiro/skills/。OpenCode 等 Agent-Skills 宿主用 git clone 加 symlink 到对应 skills 目录。
可编辑安装：若打算直接修改 references/style-guide.md，因 marketplace 安装会被更新覆盖，应 git clone 后 symlink 到 ~/.claude/skills/ 等目录，或对 Pi 执行 pi install ~/code/diagram-design。使用 profile（~/.diagram-design/profiles/）或项目标记（.diagram-design）时，marketplace 安装也不会丢失品牌配置。
验证方式（三项证据）：打开 assets/index.html 应看到全部 39 种图，无需服务器和网络（Google 字体除外）；运行 drawio_extract.py 对 fixture 输出 IR，运行 self_check.py 对示例 HTML 输出 OK；在聊天中执行 /diagram-design:doctor 或 /diagram-design:doctor --strict --json（Pi / Factory Droid 用 /doctor），输出固定格式的 Doctor summary 与 PASS/WARN/FAIL 条目。doctor 为只读，不装包、不改文件、不跑破坏性 git 命令，分 Installed-skill 模式与 Maintainer-checkout 模式。
限制与实测陷阱：macOS 自带 /usr/bin/python3 为 3.9.6，doctor 会按设计报 FAIL，但三个脚本在 3.9.6 上仍返回 0，建议将 python3 指向 Homebrew 版本而非忽略 doctor。另一陷阱是 doctor 误报 Playwright 未安装：其检测命令 import playwright; print(playwright.version) 会因该模块无 version 属性抛 AttributeError，应改用 importlib.metadata 手动确认，PNG 导出实际正常。完成标准：图库可见 39 种图、self_check.py 输出 OK 且 rc=0、doctor 能输出 summary、明确本机 python3 版本并决定修复或接受。下一步为品牌 onboarding 与 profile（资料提及 02-brand-onboarding-and-profiles.md）。