Skip to content

skills/reverse-engineering/dsl-vm-reverse/SKILL.md is missing YAML frontmatter — the module can never be auto-discovered #148

Description

@lost9999

问题

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。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions