问题
skills/reverse-engineering/dsl-vm-reverse/SKILL.md 缺少 YAML frontmatter,文件直接从 # 🔄 DSL 自定义虚拟机逆向... 开始。
影响
遵循 agentskills.io 约定的 agent 客户端(Claude Code、Cursor、Cline、Kiro 等)靠 frontmatter 的 name + description 建立 skill 索引,用于决定何时触发某个 skill。
没有 frontmatter 的后果:
- 索引里该条目的
description 为空 → agent 无法知道它何时该被调用
- 只能通过精确路径显式加载(如果宿主支持),自动路由永远命中不了
- 即"skill 存在但不可发现"
而这个模块覆盖的场景(DSL VM / fireyejs / 自定义 opcode 解释器 / 500KB+ 单行混淆 JS)在真实风控逆向里很常见,且包内 routing.md、MASTER-ROUTING.md 等 6 个文件都在引用它 —— 路由表指向一个不可发现的条目。
复现
head -3 skills/reverse-engineering/dsl-vm-reverse/SKILL.md
# 期望看到 --- / name: / description: / ---
# 实际: # 🔄 DSL 自定义虚拟机逆向(DSL VM Reverse Engineering)
对比:包内其余 82 个 SKILL.md 全部带合规 frontmatter(用 Hermes 的 frontmatter 解析器逐个验证过),只有这一个缺失。
建议修复
在文件开头补:
---
name: dsl-vm-reverse
description: Use when 逆向 DSL VM/自定义 opcode 虚拟机/fireyejs 风控引擎。
---
正文不需要改动。
描述长度提示:部分客户端会把索引里的 description 截断到 ~60 字符,所以触发关键词建议放在前 57 个字符内。
备注
我在自己的宿主(Hermes)里用挂载层覆盖的方式做了临时兜底,没有改动仓库任何文件。这个 issue 是希望上游把它修掉,让所有客户端都能正常发现该模块。
需要的话我可以直接提 PR。
问题
skills/reverse-engineering/dsl-vm-reverse/SKILL.md缺少 YAML frontmatter,文件直接从# 🔄 DSL 自定义虚拟机逆向...开始。影响
遵循 agentskills.io 约定的 agent 客户端(Claude Code、Cursor、Cline、Kiro 等)靠 frontmatter 的
name+description建立 skill 索引,用于决定何时触发某个 skill。没有 frontmatter 的后果:
description为空 → agent 无法知道它何时该被调用而这个模块覆盖的场景(DSL VM / fireyejs / 自定义 opcode 解释器 / 500KB+ 单行混淆 JS)在真实风控逆向里很常见,且包内
routing.md、MASTER-ROUTING.md等 6 个文件都在引用它 —— 路由表指向一个不可发现的条目。复现
对比:包内其余 82 个
SKILL.md全部带合规 frontmatter(用 Hermes 的 frontmatter 解析器逐个验证过),只有这一个缺失。建议修复
在文件开头补:
正文不需要改动。
备注
我在自己的宿主(Hermes)里用挂载层覆盖的方式做了临时兜底,没有改动仓库任何文件。这个 issue 是希望上游把它修掉,让所有客户端都能正常发现该模块。
需要的话我可以直接提 PR。