@topmindspace/tms-skills 2.0.1 → 2.0.2

package/CHANGELOG.md

@@ -1,134 +1,139 @@
-# Changelog
-
-所有 monorepo 变更记录见本文件。
-
-## 2.0.1 — 2026-09-24（文档 + 发布链路）
-
-### Changed
-- 文档全面对齐「双通道分发」：npm [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 已公开发布（`2.0.0` 起），GitHub 直装仍可用。
-- 明确 **GitHub ≠ npm 自动同步**：push 不更新 npm；**tag `v*` → `release.yml` 自动 npm publish**。
-- `release.yml` 启用 npm 发布步骤（Secret `NPM_TOKEN`）；`docs/PUBLISHING.md` 补版本策略、打包矩阵 npm 列、排错表。
-
-## 2.0.0 — 2026-09-24（技能 9.1.0 · 仓库/技能更名 + 层级扁平化）
-
-### Published
-- 首次发布公共 npm：[`@topmindspace/tms-skills@2.0.0`](https://www.npmjs.com/package/@topmindspace/tms-skills)
-- 安装：`npx @topmindspace/tms-skills install top-ppt-html`
-
-### Changed
-- **仓库更名**：GitHub `topmindspace/topskills` → **`topmindspace/tms-skills`**（旧 URL 301）；本地根目录、`git remote`、npm 包名 `@topmindspace/tms-skills`、CLI `tms-skills` / `bin/tms-skills.js` 全部对齐。
-- **技能更名**：`top-slides-expert` / TopSlides Expert → **`top-ppt-html` / TopPPT HTML**（目录、frontmatter `name`、分发包、文档一致）。
-- **注入标记**：`__TOPSLIDES_*__` → `__TOPPPT_*__`；**环境变量**：`TOP_SLIDES_*` → `TOP_PPT_*`；**JS API**：`TopSlidesPptx` → `TopPptHtml`。
-- **层级扁平化**：移除冗余的 `skills/` 中间层，技能目录直接放在仓库根（`top-ppt-html/`）；安装器改为扫描根目录下含 `SKILL.md` 的技能目录。
-- 版本：技能 `9.0.1` → **`9.1.0`**（`layout-constants.json` `version: 9.1`）；monorepo `1.1.1` → **`2.0.0`**（包名/CLI/结构破坏性变更）。
-
-### Migration
-| Old | New |
-|-----|-----|
-| repo `topmindspace/topskills` | `topmindspace/tms-skills` |
-| npm `@topmindspace/topskills` | `@topmindspace/tms-skills` |
-| CLI `topskills` / `bin/topskills.js` | `tms-skills` / `bin/tms-skills.js` |
-| skill id / dir `top-slides-expert` | `top-ppt-html` |
-| brand `TopSlides Expert` | `TopPPT HTML` |
-| `skills/<id>/` | `<id>/`（仓库根） |
-| `__TOPSLIDES_*__` markers | `__TOPPPT_*__` |
-| `TOP_SLIDES_*` env | `TOP_PPT_*` |
-| `TopSlidesPptx` | `TopPptHtml` |
-
-无静默别名；旧标识见 `docs/PUBLISHING.md` 废弃清单，仅 CHANGELOG / 迁移说明可提及。
-
-## 1.1.1 — 2026-09-23（技能 9.0.1 · PPTX 往返与双形态修复）
-
-### Fixed
-- **PPTX 双形态载荷静默丢字**：`build_pptx.js` / `pptx-export.js` 用 `typeof x === 'object'` 区分 `[[t,d]…]` 与 `[{t,d,accent}…]`，但 `typeof [] === 'object'`，数组形态 steps/levels/lane/nodes 的标题与描述被读成 `undefined` 后落空（第 8 章 steps 仅 4/7 关键串）。改为 `isRec()`（非数组对象）判定，双引擎同步。
-- **PPTX 模型往返误报（挡交付）**：`validate_pptx.validate_model_roundtrip` 关键串比对语料原先只取幻灯片形状文本，把原生图表 `chart.labels`（落在 chart part）和 notes-only 字段（`lead` / `image.hint` 等）误判为 `MODEL_ROUNDTRIP_CONTENT_MISSING`；v9 将 `roundtripMin` 提到 0.80 后 9 个随包示例全部 FAIL。现语料改为 **形状文本 ∪ 演讲者备注 ∪ 关联 chart part 文本**（`_roundtrip_corpus` + `slide_chart_text`），`slide_notes` 真正参与内容比对；探针跳过 `hint`/`src`/`alt` 等元数据键。
-- 示例矩阵顶层金字塔描述过长触发 `CONTAINER_OVERFLOW`：顶层槽位收窄后改为「自动执行」；9 示例 `validate_pptx --strict --model` 全 0/0。
-
-### Changed
-- 随包示例按 v9.0 模板重建（内嵌 MODEL_SCHEMA 8.3 → 9.0）；4 张 `theme-overview*.png` 主题参考图刷新。
-- 版本：技能 `9.0.0` → **`9.0.1`**（`package.json` npm 语义化）；monorepo `1.1.0` → **`1.1.1`**。版本单源仍为 `layout-constants.json` `version: 9.0`。
-
-### Verified
-- 全链路回归通过：HTML strict + B 通道精导 strict 0/0 + A 通道 strict 0/0 + 双区组合页探针 + 深色主题探针 + `negative_tests` + 任务路由遍历 + python-pptx 双裁判。
-- 审计全绿：`audit_styles` / `audit_docs` / `audit_skill` / `audit_css`；`package_skill.py --check` 通过。
-
-## 1.1.0 — 2026-09-23（安装口径 + 隐私门禁）
-
-### Changed
-- **安装口径改为 GitHub 优先**：根 README / 技能 README / `bin/topskills.js` / `docs/PUBLISHING.md` 统一以 `npx github:topmindspace/topskills ...` 为默认；npm 包名降为「已 publish 后的可选通道」。补充「找不到这个包」排错说明。
-- `package.json` description 与新增 `npm run privacy` 脚本对齐上述口径。
-
-### Fixed
-- **隐私扫描器自身泄漏**：`ci_privacy_scan.py` 不再硬编码本机用户名；改为通用 home 用户名段检测 + 可选本地词表 `scripts/.privacy-deny.local`（gitignore）。
-- **扫描器自扫失明**：旧版词表写在 raw string 里导致字面量扫不到自己；新版附合成样本自检，并拒绝在扫描器源码中出现用户名形态 token。
-- **CI 日志二次泄漏**：扫描命中项一律脱敏输出（`xx***y(len=n)`），不回显密钥/路径原文。
-- 删除本地临时脚本 `scripts/_find_dup.py`（`scripts/_*` 约定为用后即删）。
-
-### Added
-- 隐私扫描扩展：GitHub/npm token、AWS key、Bearer、密钥赋值形态；`git ls-files` 禁止跟踪路径门禁（临时脚本 / `.env` / 密钥 / 缓存 / 智能体本地状态）。
-- `docs/PUBLISHING.md` 增加安装口径表、隐私扫描器自身约束、打包矩阵中的 `.privacy-deny.local` 行。
-
-## 9.0.0 — 2026-09-23（v9 质量整改）
-
-### Added
-- `references/reform-plan.md`：整体整改方案（根因 / 设定纠偏 / 复杂度收敛 / 门禁重建 / 图文演讲 V1–V4 / **布局语法**）。
-- **`references/layout-grammar.md`**：布局语法——12 列网格、预设骨架 **P1–P12**、元素级排版（图标/列表/卡/指标/图表/图文/结构图）、组合槽位、对齐与填充率。
-- `layout-constants.layoutSystem`：骨架/元素/填充率/多重心/对齐/`pageToPreset`/`defaultCharts` 单源。
-- v9 硬门禁：`HTML_TAG_IN_TEXT` / `TITLE_ONLY_PAGE` / `UNDERFILL_PAGE` / `CHART_SKEW_INVALID` / `CHART_OVERSIZE`。
-- **`LAYOUT_*` 门禁**：`NO_SKELETON` / `MULTI_FOCUS` / `ALIGN_DRIFT` / `SPACING_OFF_TOKEN` / `ICON_SIZE` / `LABEL_COLLIDE` / `FILL`。
-- scaffold：`PAGE_TO_PRESET` + `data-skel`/`data-page-type`/`layoutPreset`；图/exhibit 页强制 P8 主从；默认图表 8 核心轮换。
-- **`render_from_model.py`**：模型驱动生成 HTML（只填 REPORT_MODEL，`--inplace` 回填正文；`[n]` 自动转 cite）。
-- 结构图正交箭头：`engine.css` `.lane__arr`/`.arch__conn`/`.flow-*`；PPTX lane/diagram 线段+三角箭头。
-- `layoutSlots` 并入 `layout-constants`（`lib_layout_regions` 优先读 LC）；cards 双端兼容 `[[k,v]]`/`str`/`{t,d}`。
-- `cross_verify` 逐页文本改为 **≥80% 覆盖**（与 roundtripMin 同源）。
-- playbook §〇 排版总序 + §三-b 图文演讲 V1–V4；content-rules §二-b 模型字段禁 HTML 标签。
-- 负向测试 N15–N17（标签泄漏 / 极偏 donut / 模型夹带标签）。
-
-### Fixed
-- SKILL.md 超重与 references 内容重复（audit_skill）；CSS 未引用类清零（`flow-*` 接入 scaffold）。
-- render_from_model：agenda 对齐、Exhibit 顺序编号、donut/matrix/threecol/halftable/comparison 版式类映射。
-- cards 双端 points 形态兼容；页高估算按栅格折行 + 8% 容差。
-- 临时脚本与死代码清理；tech-design/README 单写路径对齐。
-
-### Docs
-- 根 README / PUBLISHING 中文化；技能 `description` 重写（445 字，做什么+何时用+何时不用）。
-- README 历史版本长文移除，统一看本 CHANGELOG；版本表述统一 v9.0。
-
-### Changed
-- 过空页、留白失衡（任一轴）、大图、文本溢出、内容保真（50%→80%）纳入 strict。
-- 废除「presentation 每页 1 张大图」；图表面积随信息复杂度。
-- scaffold `cards` 契约改为 `{title, points[]}`（与双引擎一致，修复空卡）。
-- `extract_model` 自动剥离模型字段中的 HTML 标签。
-- 承载口径扩展（ul/arch/lane/…）；页高估算改重承载 + 8% 静态容差。
-
-## 1.0.0 — 2026-09-23
-
-### Added
-- `@topmindspace/topskills` monorepo with `npx` installer (`topskills list|install`).
-- GitHub Actions CI (audit + package gate + privacy scan) and release workflow.
-- MIT license and release-ready root documentation.
-
-### Changed
-- Skill renamed **`topreport` / TopReport → `top-slides-expert` / TopSlides Expert**.
-- Environment variables renamed: `TOPREPORT_*` → `TOP_SLIDES_*`.
-- Injection markers renamed: `__TOPREPORT_*__` → `__TOPSLIDES_*__`.
-- JS API renamed: `TopReportPptx` → `TopSlidesPptx`.
-- Skill lives at `skills/top-slides-expert/` so more skills can join this repo.
-
-### Removed / deprecated
-- Legacy `topreport`, `TopReport`, `TOPREPORT_*`, `MIGA_*` identifiers (no silent aliases).
-- Private host path probes and IDE/agent local state from the publishable tree.
-- Internal optimization planning notes (`OPTIMIZATION-PLAN.md`) from the release tree.
-- Build artifacts (`dist/`, `node_modules/`, caches) from version control.
-
-### Migration
-| Old | New |
-|-----|-----|
-| skill id `topreport` | `top-slides-expert` |
-| brand `TopReport` | `TopSlides Expert` |
-| `TOPREPORT_NODE_EXE` | `TOP_SLIDES_NODE_EXE` |
-| `TOPREPORT_NODE_PATH` | `TOP_SLIDES_NODE_PATH` |
-| `TOPREPORT_BROWSER_CHANNEL` | `TOP_SLIDES_BROWSER_CHANNEL` |
-| `__TOPREPORT_*__` markers | `__TOPSLIDES_*__` |
-| `TopReportPptx` | `TopSlidesPptx` |
-| `MIGA_*` env | removed — use `TOP_SLIDES_*` |
+# Changelog
+
+所有 monorepo 变更记录见本文件。
+
+## 2.0.2 — 2026-09-24（发布流水线校验）
+
+### Changed
+- 校验 **tag `v*` → GitHub Release + 自动 npm publish**（Secret `NPM_TOKEN`）链路。
+
+## 2.0.1 — 2026-09-24（文档 + 发布链路）
+
+### Changed
+- 文档全面对齐「双通道分发」：npm [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 已公开发布（`2.0.0` 起），GitHub 直装仍可用。
+- 明确 **GitHub ≠ npm 自动同步**：push 不更新 npm；**tag `v*` → `release.yml` 自动 npm publish**。
+- `release.yml` 启用 npm 发布步骤（Secret `NPM_TOKEN`）；`docs/PUBLISHING.md` 补版本策略、打包矩阵 npm 列、排错表。
+
+## 2.0.0 — 2026-09-24（技能 9.1.0 · 仓库/技能更名 + 层级扁平化）
+
+### Published
+- 首次发布公共 npm：[`@topmindspace/tms-skills@2.0.0`](https://www.npmjs.com/package/@topmindspace/tms-skills)
+- 安装：`npx @topmindspace/tms-skills install top-ppt-html`
+
+### Changed
+- **仓库更名**：GitHub `topmindspace/topskills` → **`topmindspace/tms-skills`**（旧 URL 301）；本地根目录、`git remote`、npm 包名 `@topmindspace/tms-skills`、CLI `tms-skills` / `bin/tms-skills.js` 全部对齐。
+- **技能更名**：`top-slides-expert` / TopSlides Expert → **`top-ppt-html` / TopPPT HTML**（目录、frontmatter `name`、分发包、文档一致）。
+- **注入标记**：`__TOPSLIDES_*__` → `__TOPPPT_*__`；**环境变量**：`TOP_SLIDES_*` → `TOP_PPT_*`；**JS API**：`TopSlidesPptx` → `TopPptHtml`。
+- **层级扁平化**：移除冗余的 `skills/` 中间层，技能目录直接放在仓库根（`top-ppt-html/`）；安装器改为扫描根目录下含 `SKILL.md` 的技能目录。
+- 版本：技能 `9.0.1` → **`9.1.0`**（`layout-constants.json` `version: 9.1`）；monorepo `1.1.1` → **`2.0.0`**（包名/CLI/结构破坏性变更）。
+
+### Migration
+| Old | New |
+|-----|-----|
+| repo `topmindspace/topskills` | `topmindspace/tms-skills` |
+| npm `@topmindspace/topskills` | `@topmindspace/tms-skills` |
+| CLI `topskills` / `bin/topskills.js` | `tms-skills` / `bin/tms-skills.js` |
+| skill id / dir `top-slides-expert` | `top-ppt-html` |
+| brand `TopSlides Expert` | `TopPPT HTML` |
+| `skills/<id>/` | `<id>/`（仓库根） |
+| `__TOPSLIDES_*__` markers | `__TOPPPT_*__` |
+| `TOP_SLIDES_*` env | `TOP_PPT_*` |
+| `TopSlidesPptx` | `TopPptHtml` |
+
+无静默别名；旧标识见 `docs/PUBLISHING.md` 废弃清单，仅 CHANGELOG / 迁移说明可提及。
+
+## 1.1.1 — 2026-09-23（技能 9.0.1 · PPTX 往返与双形态修复）
+
+### Fixed
+- **PPTX 双形态载荷静默丢字**：`build_pptx.js` / `pptx-export.js` 用 `typeof x === 'object'` 区分 `[[t,d]…]` 与 `[{t,d,accent}…]`，但 `typeof [] === 'object'`，数组形态 steps/levels/lane/nodes 的标题与描述被读成 `undefined` 后落空（第 8 章 steps 仅 4/7 关键串）。改为 `isRec()`（非数组对象）判定，双引擎同步。
+- **PPTX 模型往返误报（挡交付）**：`validate_pptx.validate_model_roundtrip` 关键串比对语料原先只取幻灯片形状文本，把原生图表 `chart.labels`（落在 chart part）和 notes-only 字段（`lead` / `image.hint` 等）误判为 `MODEL_ROUNDTRIP_CONTENT_MISSING`；v9 将 `roundtripMin` 提到 0.80 后 9 个随包示例全部 FAIL。现语料改为 **形状文本 ∪ 演讲者备注 ∪ 关联 chart part 文本**（`_roundtrip_corpus` + `slide_chart_text`），`slide_notes` 真正参与内容比对；探针跳过 `hint`/`src`/`alt` 等元数据键。
+- 示例矩阵顶层金字塔描述过长触发 `CONTAINER_OVERFLOW`：顶层槽位收窄后改为「自动执行」；9 示例 `validate_pptx --strict --model` 全 0/0。
+
+### Changed
+- 随包示例按 v9.0 模板重建（内嵌 MODEL_SCHEMA 8.3 → 9.0）；4 张 `theme-overview*.png` 主题参考图刷新。
+- 版本：技能 `9.0.0` → **`9.0.1`**（`package.json` npm 语义化）；monorepo `1.1.0` → **`1.1.1`**。版本单源仍为 `layout-constants.json` `version: 9.0`。
+
+### Verified
+- 全链路回归通过：HTML strict + B 通道精导 strict 0/0 + A 通道 strict 0/0 + 双区组合页探针 + 深色主题探针 + `negative_tests` + 任务路由遍历 + python-pptx 双裁判。
+- 审计全绿：`audit_styles` / `audit_docs` / `audit_skill` / `audit_css`；`package_skill.py --check` 通过。
+
+## 1.1.0 — 2026-09-23（安装口径 + 隐私门禁）
+
+### Changed
+- **安装口径改为 GitHub 优先**：根 README / 技能 README / `bin/topskills.js` / `docs/PUBLISHING.md` 统一以 `npx github:topmindspace/topskills ...` 为默认；npm 包名降为「已 publish 后的可选通道」。补充「找不到这个包」排错说明。
+- `package.json` description 与新增 `npm run privacy` 脚本对齐上述口径。
+
+### Fixed
+- **隐私扫描器自身泄漏**：`ci_privacy_scan.py` 不再硬编码本机用户名；改为通用 home 用户名段检测 + 可选本地词表 `scripts/.privacy-deny.local`（gitignore）。
+- **扫描器自扫失明**：旧版词表写在 raw string 里导致字面量扫不到自己；新版附合成样本自检，并拒绝在扫描器源码中出现用户名形态 token。
+- **CI 日志二次泄漏**：扫描命中项一律脱敏输出（`xx***y(len=n)`），不回显密钥/路径原文。
+- 删除本地临时脚本 `scripts/_find_dup.py`（`scripts/_*` 约定为用后即删）。
+
+### Added
+- 隐私扫描扩展：GitHub/npm token、AWS key、Bearer、密钥赋值形态；`git ls-files` 禁止跟踪路径门禁（临时脚本 / `.env` / 密钥 / 缓存 / 智能体本地状态）。
+- `docs/PUBLISHING.md` 增加安装口径表、隐私扫描器自身约束、打包矩阵中的 `.privacy-deny.local` 行。
+
+## 9.0.0 — 2026-09-23（v9 质量整改）
+
+### Added
+- `references/reform-plan.md`：整体整改方案（根因 / 设定纠偏 / 复杂度收敛 / 门禁重建 / 图文演讲 V1–V4 / **布局语法**）。
+- **`references/layout-grammar.md`**：布局语法——12 列网格、预设骨架 **P1–P12**、元素级排版（图标/列表/卡/指标/图表/图文/结构图）、组合槽位、对齐与填充率。
+- `layout-constants.layoutSystem`：骨架/元素/填充率/多重心/对齐/`pageToPreset`/`defaultCharts` 单源。
+- v9 硬门禁：`HTML_TAG_IN_TEXT` / `TITLE_ONLY_PAGE` / `UNDERFILL_PAGE` / `CHART_SKEW_INVALID` / `CHART_OVERSIZE`。
+- **`LAYOUT_*` 门禁**：`NO_SKELETON` / `MULTI_FOCUS` / `ALIGN_DRIFT` / `SPACING_OFF_TOKEN` / `ICON_SIZE` / `LABEL_COLLIDE` / `FILL`。
+- scaffold：`PAGE_TO_PRESET` + `data-skel`/`data-page-type`/`layoutPreset`；图/exhibit 页强制 P8 主从；默认图表 8 核心轮换。
+- **`render_from_model.py`**：模型驱动生成 HTML（只填 REPORT_MODEL，`--inplace` 回填正文；`[n]` 自动转 cite）。
+- 结构图正交箭头：`engine.css` `.lane__arr`/`.arch__conn`/`.flow-*`；PPTX lane/diagram 线段+三角箭头。
+- `layoutSlots` 并入 `layout-constants`（`lib_layout_regions` 优先读 LC）；cards 双端兼容 `[[k,v]]`/`str`/`{t,d}`。
+- `cross_verify` 逐页文本改为 **≥80% 覆盖**（与 roundtripMin 同源）。
+- playbook §〇 排版总序 + §三-b 图文演讲 V1–V4；content-rules §二-b 模型字段禁 HTML 标签。
+- 负向测试 N15–N17（标签泄漏 / 极偏 donut / 模型夹带标签）。
+
+### Fixed
+- SKILL.md 超重与 references 内容重复（audit_skill）；CSS 未引用类清零（`flow-*` 接入 scaffold）。
+- render_from_model：agenda 对齐、Exhibit 顺序编号、donut/matrix/threecol/halftable/comparison 版式类映射。
+- cards 双端 points 形态兼容；页高估算按栅格折行 + 8% 容差。
+- 临时脚本与死代码清理；tech-design/README 单写路径对齐。
+
+### Docs
+- 根 README / PUBLISHING 中文化；技能 `description` 重写（445 字，做什么+何时用+何时不用）。
+- README 历史版本长文移除，统一看本 CHANGELOG；版本表述统一 v9.0。
+
+### Changed
+- 过空页、留白失衡（任一轴）、大图、文本溢出、内容保真（50%→80%）纳入 strict。
+- 废除「presentation 每页 1 张大图」；图表面积随信息复杂度。
+- scaffold `cards` 契约改为 `{title, points[]}`（与双引擎一致，修复空卡）。
+- `extract_model` 自动剥离模型字段中的 HTML 标签。
+- 承载口径扩展（ul/arch/lane/…）；页高估算改重承载 + 8% 静态容差。
+
+## 1.0.0 — 2026-09-23
+
+### Added
+- `@topmindspace/topskills` monorepo with `npx` installer (`topskills list|install`).
+- GitHub Actions CI (audit + package gate + privacy scan) and release workflow.
+- MIT license and release-ready root documentation.
+
+### Changed
+- Skill renamed **`topreport` / TopReport → `top-slides-expert` / TopSlides Expert**.
+- Environment variables renamed: `TOPREPORT_*` → `TOP_SLIDES_*`.
+- Injection markers renamed: `__TOPREPORT_*__` → `__TOPSLIDES_*__`.
+- JS API renamed: `TopReportPptx` → `TopSlidesPptx`.
+- Skill lives at `skills/top-slides-expert/` so more skills can join this repo.
+
+### Removed / deprecated
+- Legacy `topreport`, `TopReport`, `TOPREPORT_*`, `MIGA_*` identifiers (no silent aliases).
+- Private host path probes and IDE/agent local state from the publishable tree.
+- Internal optimization planning notes (`OPTIMIZATION-PLAN.md`) from the release tree.
+- Build artifacts (`dist/`, `node_modules/`, caches) from version control.
+
+### Migration
+| Old | New |
+|-----|-----|
+| skill id `topreport` | `top-slides-expert` |
+| brand `TopReport` | `TopSlides Expert` |
+| `TOPREPORT_NODE_EXE` | `TOP_SLIDES_NODE_EXE` |
+| `TOPREPORT_NODE_PATH` | `TOP_SLIDES_NODE_PATH` |
+| `TOPREPORT_BROWSER_CHANNEL` | `TOP_SLIDES_BROWSER_CHANNEL` |
+| `__TOPREPORT_*__` markers | `__TOPSLIDES_*__` |
+| `TopReportPptx` | `TopSlidesPptx` |
+| `MIGA_*` env | removed — use `TOP_SLIDES_*` |

package/bin/tms-skills.js

@@ -1,160 +1,160 @@
-#!/usr/bin/env node
-/**
- * tms-skills — TopMindspace agent skills installer
- *
- * Usage (GitHub is the primary install source — npm publish is optional):
- *   npx github:topmindspace/tms-skills list
- *   npx github:topmindspace/tms-skills install top-ppt-html
- *   npx github:topmindspace/tms-skills install top-ppt-html --to ./skills-out
- *   npx @topmindspace/tms-skills install top-ppt-html   # only after npm publish
- */
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..');
-// Skills live at repo root (one directory per skill with SKILL.md).
-const INFRA_DIRS = new Set(['bin', 'docs', 'scripts', 'node_modules', 'dist', 'release-assets']);
-
-function die(msg, code = 1) {
-  console.error(msg);
-  process.exit(code);
-}
-
-function skillDir(skillId) {
-  return path.join(ROOT, skillId);
-}
-
-function listSkillIds() {
-  return fs
-    .readdirSync(ROOT, { withFileTypes: true })
-    .filter((d) => d.isDirectory() && !INFRA_DIRS.has(d.name) && !d.name.startsWith('.'))
-    .filter((d) => fs.existsSync(path.join(ROOT, d.name, 'SKILL.md')))
-    .map((d) => d.name)
-    .sort();
-}
-
-function readSkillMeta(skillId) {
-  const skillPath = skillDir(skillId);
-  const skillMd = path.join(skillPath, 'SKILL.md');
-  if (!fs.existsSync(skillMd)) return { id: skillId, description: '' };
-  const text = fs.readFileSync(skillMd, 'utf8');
-  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!m) return { id: skillId, description: '' };
-  const desc = (m[1].match(/^description:\s*"(.*)"\s*$/m) || m[1].match(/^description:\s*(.+)\s*$/m) || [])[1] || '';
-  return { id: skillId, description: String(desc).slice(0, 120) };
-}
-
-function resolveDefaultTarget() {
-  const candidates = [
-    path.join(process.cwd(), '.agents', 'skills'),
-    path.join(process.cwd(), '.claude', 'skills'),
-    path.join(process.cwd(), '.mimocode', 'skills'),
-    path.join(process.env.HOME || process.env.USERPROFILE || '', '.claude', 'skills'),
-    path.join(process.env.HOME || process.env.USERPROFILE || '', '.agents', 'skills'),
-  ];
-  for (const dir of candidates) {
-    if (dir && fs.existsSync(path.dirname(dir))) {
-      return dir;
-    }
-  }
-  return path.join(process.cwd(), '.agents', 'skills');
-}
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const s = path.join(src, entry.name);
-    const d = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name === '__pycache__') continue;
-      copyDir(s, d);
-    } else if (entry.isFile()) {
-      if (entry.name.endsWith('.pyc')) continue;
-      fs.copyFileSync(s, d);
-    }
-  }
-}
-
-function install(skillId, targetRoot) {
-  const src = skillDir(skillId);
-  if (!fs.existsSync(path.join(src, 'SKILL.md'))) {
-    die(`Skill not found: ${skillId}\nAvailable: ${listSkillIds().join(', ') || '(none)'}`);
-  }
-  const dest = path.join(targetRoot, skillId);
-  fs.mkdirSync(targetRoot, { recursive: true });
-  if (fs.existsSync(dest)) {
-    fs.rmSync(dest, { recursive: true, force: true });
-  }
-  copyDir(src, dest);
-  console.log(`Installed ${skillId}`);
-  console.log(`  from ${src}`);
-  console.log(`  to   ${dest}`);
-  console.log('');
-  console.log('Optional (PPTX export only):');
-  console.log(`  cd "${dest}" && npm install`);
-}
-
-function usage() {
-  console.log(`tms-skills — install TopMindspace agent skills
-
-Usage:
-  tms-skills list
-  tms-skills install <skill-id> [--to <dir>]
-  tms-skills help
-
-Examples:
-  npx github:topmindspace/tms-skills list
-  npx github:topmindspace/tms-skills install top-ppt-html
-  npx github:topmindspace/tms-skills install top-ppt-html --to ./.agents/skills
-
-  # Optional npm package (only after @topmindspace/tms-skills is published):
-  npx @topmindspace/tms-skills install top-ppt-html
-`);
-}
-
-function main(argv) {
-  const args = argv.slice(2);
-  const cmd = args[0];
-
-  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
-    usage();
-    return;
-  }
-
-  if (cmd === 'list' || cmd === 'ls') {
-    const ids = listSkillIds();
-    if (!ids.length) {
-      console.log('No skills found in package.');
-      return;
-    }
-    for (const id of ids) {
-      const meta = readSkillMeta(id);
-      console.log(`${id}`);
-      if (meta.description) console.log(`  ${meta.description}…`);
-    }
-    return;
-  }
-
-  if (cmd === 'install') {
-    const skillId = args[1];
-    if (!skillId || skillId.startsWith('-')) {
-      die('Missing skill id.\n\n' + usage());
-    }
-    let to = null;
-    for (let i = 2; i < args.length; i++) {
-      if (args[i] === '--to' || args[i] === '-t') {
-        to = args[++i];
-        if (!to) die('Option --to requires a directory path.');
-      }
-    }
-    const targetRoot = to ? path.resolve(to) : resolveDefaultTarget();
-    install(skillId, targetRoot);
-    return;
-  }
-
-  die(`Unknown command: ${cmd}\n\n` + usage());
-}
-
-main(process.argv);
+#!/usr/bin/env node
+/**
+ * tms-skills — TopMindspace agent skills installer
+ *
+ * Usage (GitHub is the primary install source — npm publish is optional):
+ *   npx github:topmindspace/tms-skills list
+ *   npx github:topmindspace/tms-skills install top-ppt-html
+ *   npx github:topmindspace/tms-skills install top-ppt-html --to ./skills-out
+ *   npx @topmindspace/tms-skills install top-ppt-html   # only after npm publish
+ */
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..');
+// Skills live at repo root (one directory per skill with SKILL.md).
+const INFRA_DIRS = new Set(['bin', 'docs', 'scripts', 'node_modules', 'dist', 'release-assets']);
+
+function die(msg, code = 1) {
+  console.error(msg);
+  process.exit(code);
+}
+
+function skillDir(skillId) {
+  return path.join(ROOT, skillId);
+}
+
+function listSkillIds() {
+  return fs
+    .readdirSync(ROOT, { withFileTypes: true })
+    .filter((d) => d.isDirectory() && !INFRA_DIRS.has(d.name) && !d.name.startsWith('.'))
+    .filter((d) => fs.existsSync(path.join(ROOT, d.name, 'SKILL.md')))
+    .map((d) => d.name)
+    .sort();
+}
+
+function readSkillMeta(skillId) {
+  const skillPath = skillDir(skillId);
+  const skillMd = path.join(skillPath, 'SKILL.md');
+  if (!fs.existsSync(skillMd)) return { id: skillId, description: '' };
+  const text = fs.readFileSync(skillMd, 'utf8');
+  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!m) return { id: skillId, description: '' };
+  const desc = (m[1].match(/^description:\s*"(.*)"\s*$/m) || m[1].match(/^description:\s*(.+)\s*$/m) || [])[1] || '';
+  return { id: skillId, description: String(desc).slice(0, 120) };
+}
+
+function resolveDefaultTarget() {
+  const candidates = [
+    path.join(process.cwd(), '.agents', 'skills'),
+    path.join(process.cwd(), '.claude', 'skills'),
+    path.join(process.cwd(), '.mimocode', 'skills'),
+    path.join(process.env.HOME || process.env.USERPROFILE || '', '.claude', 'skills'),
+    path.join(process.env.HOME || process.env.USERPROFILE || '', '.agents', 'skills'),
+  ];
+  for (const dir of candidates) {
+    if (dir && fs.existsSync(path.dirname(dir))) {
+      return dir;
+    }
+  }
+  return path.join(process.cwd(), '.agents', 'skills');
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name === '__pycache__') continue;
+      copyDir(s, d);
+    } else if (entry.isFile()) {
+      if (entry.name.endsWith('.pyc')) continue;
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+function install(skillId, targetRoot) {
+  const src = skillDir(skillId);
+  if (!fs.existsSync(path.join(src, 'SKILL.md'))) {
+    die(`Skill not found: ${skillId}\nAvailable: ${listSkillIds().join(', ') || '(none)'}`);
+  }
+  const dest = path.join(targetRoot, skillId);
+  fs.mkdirSync(targetRoot, { recursive: true });
+  if (fs.existsSync(dest)) {
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+  copyDir(src, dest);
+  console.log(`Installed ${skillId}`);
+  console.log(`  from ${src}`);
+  console.log(`  to   ${dest}`);
+  console.log('');
+  console.log('Optional (PPTX export only):');
+  console.log(`  cd "${dest}" && npm install`);
+}
+
+function usage() {
+  console.log(`tms-skills — install TopMindspace agent skills
+
+Usage:
+  tms-skills list
+  tms-skills install <skill-id> [--to <dir>]
+  tms-skills help
+
+Examples:
+  npx github:topmindspace/tms-skills list
+  npx github:topmindspace/tms-skills install top-ppt-html
+  npx github:topmindspace/tms-skills install top-ppt-html --to ./.agents/skills
+
+  # Optional npm package (only after @topmindspace/tms-skills is published):
+  npx @topmindspace/tms-skills install top-ppt-html
+`);
+}
+
+function main(argv) {
+  const args = argv.slice(2);
+  const cmd = args[0];
+
+  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+    usage();
+    return;
+  }
+
+  if (cmd === 'list' || cmd === 'ls') {
+    const ids = listSkillIds();
+    if (!ids.length) {
+      console.log('No skills found in package.');
+      return;
+    }
+    for (const id of ids) {
+      const meta = readSkillMeta(id);
+      console.log(`${id}`);
+      if (meta.description) console.log(`  ${meta.description}…`);
+    }
+    return;
+  }
+
+  if (cmd === 'install') {
+    const skillId = args[1];
+    if (!skillId || skillId.startsWith('-')) {
+      die('Missing skill id.\n\n' + usage());
+    }
+    let to = null;
+    for (let i = 2; i < args.length; i++) {
+      if (args[i] === '--to' || args[i] === '-t') {
+        to = args[++i];
+        if (!to) die('Option --to requires a directory path.');
+      }
+    }
+    const targetRoot = to ? path.resolve(to) : resolveDefaultTarget();
+    install(skillId, targetRoot);
+    return;
+  }
+
+  die(`Unknown command: ${cmd}\n\n` + usage());
+}
+
+main(process.argv);