Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/ryanzhao1011/workframe/migrate-to-modulesnpx skills add ryanzhao1011/workframe --skill migrate-to-modulesgit clone --depth 1 https://github.com/ryanzhao1011/workframeWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ryanzhao1011/workframe/migrate-to-modules)<a href="https://agentmods.dev/skills/ryanzhao1011/workframe/migrate-to-modules"><img src="https://agentmods.dev/badge/skills/ryanzhao1011/workframe/migrate-to-modules.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00115 | $0.03701 |
| Opus 5 | $0.00057 | $0.01851 |
| Sonnet 5 | $0.00023 | $0.00740 |
| Haiku 4.5 | $0.00012 | $0.00370 |
Grade B, and why
migrate-to-modules scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Reads agent configuration directoriesmediumAgent snooping
.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.
grep -rln "<old-path-or-keyword>" .claude/ projects/ company-context/ my-workspace/ How it starts
The opening of the file, as written. The whole thing — 318 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Migrate to Modules Skill
前置依赖
调用本 skill 前需读 skill: document-norms §1(归属矩阵)/ §3(三段制 overview)/ §4(索引层级)/ §8(修改 SOP,含删除前 grep)。
参考插件根 reference/module-architecture.md(modules/ 体系完整设计)。
定位
老项目一次性迁移到 modules/ 体系的统一入口。强约束:必须 dry-run 用户 review 后才执行实际搬运。
适用范围:
- 存量项目(典型场景:含散落 PRD / spec / decisions / plans / obsidian 归属规范文件等)
- 已有代码 + 散落需求文档的工程仓库
- 项目首次启用 modules/ 体系(一次性,不重复执行)
不适用:
- 创建单个新模块/需求 → 调
module-init - 修改已有 modules/ 结构 → 直接 Edit + 调
module-index-refresh - 仅刷新索引 → 调
module-index-refresh
输入
| 输入 | 说明 |
|---|---|
| 老资产位置(必需) | 列出 docs/ / projects/specs/ / obsidian-knowledge.md 等待迁源。逐条标注项目内 / 项目外——决定搬还是拷,见下 |
| 目标 modules/ 路径根 | 默认 projects/modules/ |
| 模块树初稿(可选) | 用户给定基础模块/子模块列表;不给则 AI 推荐 |
是否保留 _legacy/ 兜底 |
默认是;保留 projects/_legacy/<old-path>/ 备份 |
跨项目导入 = 只拷不删(硬约束):待迁源在当前项目之外时(典型场景:用户新建项目、
把老项目资料喂进来),源目录一律只读——禁止移动、删除、写入,_legacy/ 备份与
「删除老项目顶层 docs/」等清源动作全部不适用。那是用户仍在使用的仓库,动它一个字都是越界。
本 skill 默认的「搬」只对项目内的源成立。
工作流(4 步 + 强 SOP)
Step 1: 模块树设计(人工 + AI 推荐)
1.1 老资产盘点
-
全量列出待迁源文件(递归 .md / .yaml / asset / png / pdf)
-
按目录分组统计数量
-
报告:
待迁源盘点: docs/ (43 .md, 12 png, 3 pdf) docs/decisions/ (8 .md) docs/plans/ (15 .md) .claude/rules/local/obsidian-knowledge.md projects/specs/auth/ (5 .md)
1.2 AI 推荐基础模块树
读全部 .md 的 H1 + frontmatter module / tags / area,聚类推荐基础模块:
推荐基础模块(10 个,按文档密度排序):
1. profile (档案与个性化,14 文档)
2. messaging (消息与通知,10 文档)
3. payment (支付与结算,8 文档)
...
1.3 用户 review + 调整
用户可:
- 重命名基础模块
- 合并/拆分基础模块
- 提供子模块拆分建议(按需)
- 标记某些资产"不进 modules/,留在 specs/plans/" 或 "归档到 _legacy/"
输出:用户确认的模块树 + 子模块拆分(如果用户给)。
Step 2: dry-run 映射(绝对禁止跳过)
2.1 生成 file→target 映射
对每个待迁源文件,根据:
- 模块树
- frontmatter
module/tags/area - 文件路径关键词
- H1 标题语义
推断目标路径:
file → target 映射 dry-run(103 文件):
✅ 自动推断高置信(72 文件):
docs/auth/login-flow.md → modules/auth/login/requirements/login-flow/main/prd.md
docs/decisions/0042-jwt-vs-session.md → modules/auth/login/decisions/2024-12-08-jwt-vs-session.md
...
⚠️ 自动推断低置信(18 文件):
docs/misc/bot-policy.md → modules/messaging/bot/research/bot-policy.md ?
...
❓ 无法推断(8 文件):
docs/old-architecture-2023.md → ???
...
📦 建议归档 _legacy/(5 文件):
docs/2022-prd-discarded.md → _legacy/docs/2022-prd-discarded.md
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 318 lines · 115 tokens per session scan B 788bf28abd47
migrate-to-modules is a skill published in the GitHub repository ryanzhao1011/workframe (4 stars, last pushed 17d ago), licensed MIT. It adds 115 tokens to every session and 3,701 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
html-prototype
Generate HTML prototypes (single-file, browser-openable) for product mockups using the user's design system — fonts, color scales, radii, shadows, components, all driven by a tokens.css file. Use when the user asks to make a 原型 / mockup / HTML 设计图 / 设计图给前端 for a PRD module, OR redesign an existing prototype. Output…
feature-acceptance
研发提测后接管浏览器,对照 PRD(必给)+ HTML 原型(自动找)逐项验收线上实现,产出差异清单(实现 / 部分实现 / 未实现 / 与原型或 PRD 不一致)+ 截图证据 + 阻塞问题排序。Use whenever PM 说「验收 XX」「跑一下 XX」「研发提测了」「对一下需求和线上」「点一下 XX 看符不符合需求」「看哪些实现了哪些没做」「上线前 check」「灰度验收」「acceptance」「QA check」,or 给出 PRD 路径 + 线上 URL 让 Claude 走流程。也适用于 PM 想自己点某功能、判断和需求差异时陪她一起跑。区别于 prd skill:本 skill 验证线上现状,不修改 PRD…
prd
Write, rewrite, polish, restructure, or review product requirements documents (PRDs). Use whenever a task touches a 需求文档 / PRD —— 新写、重构、统一口径、补页面结构 / 字段 / 规则 / 边界 / 异常处理、加指标口径定义、按数据看板或某类骨架组织章节,或把讨论 / 会议记录整理成正式产品文档。Trigger even when the user does NOT say "写需求" —— e.g. "把这个加到…
ui-walkthrough
把一份 UI 设计 HTML 和研发上线的页面,同视口、同状态截图比对 + 读 computed style 实锤,产出 UI 还原度差异清单(结构 / 组件 / 颜色 / 字体 / 圆角 / 图标 / 间距 七维,每条标明设计值 vs 线上值)。Use whenever PM 说「UI 走查」「走查一下 UI」「对一下 UI」「UI 还原度」「还原度走查」「线上跟设计稿对一下」「前端还原得对不对」「页面跟这份 HTML 对一下」「UI 验收」「设计还原走查」,或给出 设计 HTML 路径 + 线上 URL 让 Claude 比视觉差异。区别于 feature-acceptance skill:那个验业务逻辑 / 字段 / 操作…
daily-research
Daily research briefing. When the user says "今天的调研""跑一份调研简报""每日调研""今日行业动态""扫一下最近有什么新东西""补一下今天的简报",或在会话里要求生成 / 补一份当日情报简报时,触发本 skill。它在当前会话里实时联网调研用户配置的领域(默认是 AI 应用层 / 框架 / 论文 / 模型 / 研究员与厂商落地动态),产出一份中文简报写入 /YYYY-MM-DD.md。即使用户没说"用 skill"、只说"今天调研呢""帮我看下今天有什么进展"也要触发。本 skill 只生成简报,不自动归档。.
competitor-research
建/补 竞品与 AI 调研文档时遵循。覆盖 AI 应用 / 行业产品现状(竞品库)、Agent 模块汇总与框架深挖(研究库)。规定按菜单梳理全部功能、无账号用帮助中心反推菜单、功能截图只用真实 UI 图、标题与排版口径、主题分流与增量。Use when 写竞品现状 / AI 应用产品文档 / 模块汇总 / 框架对比 / 调研沉淀。.