migrate-to-modules

migrate-to-modules is a skill for Claude Code, Codex from ryanzhao1011/workframe. It costs 115 tokens per session (3,701 once invoked), scanned B, original, MIT.

A migration workflow for moving an older project into a modules directory structure. It designs the module tree, previews each file’s new location, waits for review, then moves files, writes metadata, and rebuilds indexes.

In plain words
What is it for?
Use it to migrate scattered project documents and assets into modules, preserve backups where applicable, replace references, and rebuild the project index.
Why use it?
It reduces the risk of breaking references or losing files when reorganising an existing project, while requiring review before changes are made.

Skill for Claude CodeCodex

Part of the core plugin — 37 skills, 4 agents, 11 hooks shipped together

Install

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.

agentmods
npx agentmods add skills/ryanzhao1011/workframe/migrate-to-modules
Any agent
npx skills add ryanzhao1011/workframe --skill migrate-to-modules
Clone the repo
git clone --depth 1 https://github.com/ryanzhao1011/workframe

Made for: Claude Code, Codex.

Or install core, the plugin that ships this one along with the rest of its 37 skills, 4 agents, 11 hooks.

Wrote 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.

agentmods badge for migrate-to-modules

README.md
[![agentmods](https://agentmods.dev/badge/skills/ryanzhao1011/workframe/migrate-to-modules.svg)](https://agentmods.dev/skills/ryanzhao1011/workframe/migrate-to-modules)
Your own site
<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>
Per session 115 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,701 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce 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

Measured 4d ago against content hash 788bf28abd47, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

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/
plugins/core/skills/migrate-to-modules/SKILL.md · 318 lines

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

Read the full file on GitHub · 318 lines

Changes

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.

  1. 4d ago First seen · 318 lines · 115 tokens per session scan B 788bf28abd47

Subscribe to this mod's changes

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.

Related

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…

mayuemarsha-del/pm-skills · 97 tokens

feature-acceptance

研发提测后接管浏览器,对照 PRD(必给)+ HTML 原型(自动找)逐项验收线上实现,产出差异清单(实现 / 部分实现 / 未实现 / 与原型或 PRD 不一致)+ 截图证据 + 阻塞问题排序。Use whenever PM 说「验收 XX」「跑一下 XX」「研发提测了」「对一下需求和线上」「点一下 XX 看符不符合需求」「看哪些实现了哪些没做」「上线前 check」「灰度验收」「acceptance」「QA check」,or 给出 PRD 路径 + 线上 URL 让 Claude 走流程。也适用于 PM 想自己点某功能、判断和需求差异时陪她一起跑。区别于 prd skill:本 skill 验证线上现状,不修改 PRD…

mayuemarsha-del/pm-skills · 192 tokens

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. "把这个加到…

mayuemarsha-del/pm-skills · 202 tokens

ui-walkthrough

把一份 UI 设计 HTML 和研发上线的页面,同视口、同状态截图比对 + 读 computed style 实锤,产出 UI 还原度差异清单(结构 / 组件 / 颜色 / 字体 / 圆角 / 图标 / 间距 七维,每条标明设计值 vs 线上值)。Use whenever PM 说「UI 走查」「走查一下 UI」「对一下 UI」「UI 还原度」「还原度走查」「线上跟设计稿对一下」「前端还原得对不对」「页面跟这份 HTML 对一下」「UI 验收」「设计还原走查」,或给出 设计 HTML 路径 + 线上 URL 让 Claude 比视觉差异。区别于 feature-acceptance skill:那个验业务逻辑 / 字段 / 操作…

mayuemarsha-del/pm-skills · 231 tokens

daily-research

Daily research briefing. When the user says "今天的调研""跑一份调研简报""每日调研""今日行业动态""扫一下最近有什么新东西""补一下今天的简报",或在会话里要求生成 / 补一份当日情报简报时,触发本 skill。它在当前会话里实时联网调研用户配置的领域(默认是 AI 应用层 / 框架 / 论文 / 模型 / 研究员与厂商落地动态),产出一份中文简报写入 /YYYY-MM-DD.md。即使用户没说"用 skill"、只说"今天调研呢""帮我看下今天有什么进展"也要触发。本 skill 只生成简报,不自动归档。.

mayuemarsha-del/pm-skills · 178 tokens

competitor-research

建/补 竞品与 AI 调研文档时遵循。覆盖 AI 应用 / 行业产品现状(竞品库)、Agent 模块汇总与框架深挖(研究库)。规定按菜单梳理全部功能、无账号用帮助中心反推菜单、功能截图只用真实 UI 图、标题与排版口径、主题分流与增量。Use when 写竞品现状 / AI 应用产品文档 / 模块汇总 / 框架对比 / 调研沉淀。.

mayuemarsha-del/pm-skills · 123 tokens