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/module-index-refreshnpx skills add ryanzhao1011/workframe --skill module-index-refreshgit 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/module-index-refresh)<a href="https://agentmods.dev/skills/ryanzhao1011/workframe/module-index-refresh"><img src="https://agentmods.dev/badge/skills/ryanzhao1011/workframe/module-index-refresh.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.00110 | $0.03377 |
| Opus 5 | $0.00055 | $0.01688 |
| Sonnet 5 | $0.00022 | $0.00675 |
| Haiku 4.5 | $0.00011 | $0.00338 |
Grade B, and why
module-index-refresh 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 3d 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.
python "$(cat .claude/workframe-state/plugin-root.txt)/scripts/module_init.py" --project "<项目根>" --refresh-index [--basic "<name>"] How it starts
The opening of the file, as written. The whole thing — 202 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Module Index Refresh Skill
前置依赖
调用本 skill 前需读 skill: document-norms §3（机器维护段边界格式）/ §4（索引层级与同步规则）。
定位
modules/ 体系下机器维护索引段的唯一刷新入口。
适用范围：
- 全局
projects/modules/overview.md的basic-modules-index段 - 基础模块
<basic>/overview.md的submodules-index段 - 子模块
<sub>/overview.md的current-state-summary+requirements-index段 - 子模块需求清单
<sub>/requirements/overview.md的requirements-by-status段 - 需求
<req_slug>/overview.md的sub-requirements-index段
严格保证：
- 只重写
<!-- WORKFRAME:AUTO-INDEX:START[:<name>] -->与配对<!-- WORKFRAME:AUTO-INDEX:END[:<name>] -->之间内容（:<name>可选；命名段格式见 document-norms §3.3 + 子模块 overview 模板的current-state-summary/requirements-index双段示例） - 段外人写部分（positioning / 中间内容）零接触
- 同输入 → 同输出（可 diff 复现）
不适用：
- 修改 frontmatter
updated字段 → 由obsidian-safe-write或文档创建 skill 维护 - 修改 PRD 内容 → 由
prd-writer - 修改 current-state/ 内容 → 由
code-to-doc - 修复 broken link → 由
obsidian-link-audit
输入
| 模式 | 输入 |
|---|---|
| 增量（推荐） | 限定路径，如 <basic> / <basic>/<sub> / <basic>/<sub>/requirements/<req_slug> |
| 全量 | 无输入（递归 projects/modules/） |
工作流
Step 1: 路径解析与影响范围
按输入路径计算需刷新的 overview 文件：
| 输入路径 | 受影响 overview |
|---|---|
| 全量 | modules/overview.md + 所有 <basic>/overview.md + 所有 <sub>/overview.md + 所有 requirements/overview.md + 所有 <req_slug>/overview.md |
<basic> |
modules/overview.md + <basic>/overview.md |
<basic>/<sub> |
modules/overview.md + <basic>/overview.md + <basic>/<sub>/overview.md + <basic>/<sub>/requirements/overview.md |
<basic>/<sub>/requirements/<req_slug> |
上一行 + <req_slug>/overview.md |
优化原则：能只刷一个子模块就不全量刷。同一文件的多个 auto_sections 一次性处理，不重复读写。
Step 1.5: 顶部两层段先交给脚本（单一实现，防漂移）
modules/overview.md 的 basic-modules-index 与 <basic>/overview.md 的 submodules-index
这两类匿名段由 module_init.py 承包（它建树时也重建同两段，生成规则只此一份）：
# 全量：重建 global + 所有 basic 的段；限定：加 --basic "<name>"
# 插件根从 plugin-root.txt 取（SessionStart hook 每会话刷新），不依赖环境变量
python "$(cat .claude/workframe-state/plugin-root.txt)/scripts/module_init.py" --project "<项目根>" --refresh-index [--basic "<name>"]
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.
- 3d ago First seen · 202 lines · 110 tokens per session scan B f1ad168645da
module-index-refresh is a skill published in the GitHub repository ryanzhao1011/workframe (4 stars, last pushed 17d ago), licensed MIT. It adds 110 tokens to every session and 3,377 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 应用产品文档 / 模块汇总 / 框架对比 / 调研沉淀。.