SkillMD：一个 SKILL.md 的 linter + 工具链，让 AI 技能质量有门禁

你有没有遇到过这种情况：从网上 copy 了一个 SKILL.md，结果装上之后 AI 助手行为完全不对，甚至悄悄调用了一些危险的脚本？这种情况在 AI 工具爆发式增长的 2026 年已经非常普遍了。

今天要说的 SkillMD（GitHub 地址），就是来解决这个问题的。它是一个围绕 SKILL.md 格式的全套工具链——提供 CLI、MCP 服务器、GitHub Action，以及一个核心的 lint 引擎，既能帮你验证 Skill 文件的质量，也能对 Skill 做安全扫描，是目前这个领域里最完整的开发工具。

它能做什么？

SkillMD 整套工具分为三个层面：

1. CLI 工具（npm i -g skillmds）

• skillmd lint . — 验证 SKILL.md 文件，输出质量分数和诊断信息
• skillmd scan . — 安全扫描，检测脚本执行、网络调用、敏感信息读取等风险
• skillmd search "pdf" — 在 skillmd.com registry 搜索 Skill
• skillmd add anthropics/pdf — 安装 Skill（安装前先做 lint，不合格不让装）
• skillmd init my-skill — 快速生成符合规范的新 SKILL.md 脚手架

2. MCP 服务器

接入后，AI 助手可以在对话中直接调用 skillmd_search、skillmd_lint、skillmd_install 等工具，在对话过程中搜索、验证和安装 Skill，而不需要切换到终端。这对于深度集成的 AI 工作流非常有用。

3. GitHub Action

在 CI 里跑 skillmds/skillmd/action，每次 PR 自动对修改的 Skill 文件做 lint，结果直接上传到 GitHub Code Scanning，review 的时候就能看到 Skill 的质量报告。

核心引擎：@skillmd/core

整个工具链的核心是这个 npm 包：npm i @skillmd/core。它提供 9 条 lint 规则，加上一个逐行分析的安全扫描器，检测内容包括：

• network_calls — 是否有网络请求
• executes_scripts — 是否执行脚本
• reads_secrets — 是否读取敏感信息

输出包含三个维度：ok（是否通过）、score（0–100 质量分）、diagnostics（具体问题列表）和 security（安全标记）。可以输出 SARIF/JSON/GitHub annotation 等格式，方便集成到各种 CI 系统里。

引擎本身零运行时依赖，只依赖 yaml，ESM 编写，能跑在 Node.js、浏览器和 Edge Runtime 上。

为什么值得装？

SKILL.md 格式的兴起，某种意义上类似早年 npm 刚出来的时候——鱼龙混杂，好的坏的一起涌进来。SkillMD 的价值在于它给这个生态提供了”质量门禁”：安装前先 lint，不合格不让你装；上线前跑 scan，不安全不让过。

如果你在团队里推广 AI 助手的 Skill 使用，或者自己维护一个 Skill 集合，SkillMD 是目前最成熟的工程化方案。

快速上手

安装 CLI：

npm i -g skillmds
skillmd lint .        # 验证当前目录的 SKILL.md
skillmd scan .        # 安全扫描

在 Claude Code 里接入 MCP：

claude mcp add skillmd -- npx -y skillmds

GitHub Action 用法：

steps:
  - uses: skillmds/skillmd/action@v1
    with:
      path: .

GitHub：https://github.com/skillmds/skillmd

GitHub: https://github.com/skillmds/skillmd