@skillscraft/cli：Agent Skills 的全栈 TypeScript 工具链，让 SKILL.md 规范校验从”靠感觉”变成”靠工具”
如果你在搞 AI Agent 开发，大概率绕不开 SKILL.md 这个文件——它是给 Claude、Cursor、Copilot 这类 Agent 装技能的”说明书”。但问题来了：怎么保证你写的 SKILL.md 符合规范？格式不对、字段缺失、描述太水……这些坑我相信不少人都踩过。
今天挖到一个很对味的工具——@skillscraft/cli，一句话概括：Agent Skills 的 TypeScript 全栈工具链，从初始化到校验到发布一条龙搞定。
🎯 这玩意儿解决什么问题？
现在的 Agent 生态已经很乱了——Claude Code、Cursor、Copilot、Codex CLI、Gemini CLI、VS Code……33+ 款产品都在用 SKILL.md 作为技能格式，但市面上海量 skill 质量参差不齐，有的缺 frontmatter，有的 description 写得跟废话一样，有的 body 超过 5000 token 把上下文撑爆。
@skillscraft/cli 就是来解决这个问题的。它分三层：
- @skillscraft/spec：TypeScript 类型定义 + JSON Schema，标定”什么才是合法的 SKILL.md”
- @skillscraft/core：Parser + Validator + Linter，代码层面做校验和最佳实践检查
- @skillscraft/cli：命令行工具，5 个核心命令覆盖全流程
⚡ 5 个命令搞定一切
用过就知道有多香：
- skill init my-skill：从模板生成规范目录结构，不用再对着文档一行行搭
- skill validate ./my-skill：对照规范检查，缺字段、格式错误一目了然
- skill lint ./my-skill –fix：超越 spec 的最佳实践检查——body 是否超过 5000 token、description 是否含”when to use”触发词、是否用了 progressive disclosure……这些 Lint 规则比规范本身更严格
- skill install ./my-skill：直接安装到目标 Agent，一条命令搞定分发
- skill validate-all -d ./my-skills –strict –json：CI 友好，strict 模式把所有 warn 变 error，JSON 输出方便接入流水线
🔍 Lint 规则有多细？
让我影响最深的是这些规则——
- context-budget：body 超过 5000 token 就报警，context window 是共享资源，不能乱塞
- description-quality：description 必须含”when to use”触发词，不然 agent 根本不知道什么时候该调用你
- no-generic-instructions：检测”请仔细分析”这类模糊废话，逼你写具体
- progressive-disclosure：大技能必须拆分到 references/，不能全塞 SKILL.md
- defaults-over-menus：不能给一堆选项让 agent 自己猜，要有明确的默认行为
💡 对开发者意味着什么？
简单说：以前你写 SKILL.md 靠感觉，现在靠工具。
尤其在做内部 skill 库的时候，@skillscraft/cli 可以作为 CI 环节的强制门禁——不合规的 skill 直接拒绝合并，从源头保证 skill 质量。而且它兼容所有主流 Agent，一次编写、横跨 33+ 平台，这个复用力是实打实的。
如果你正在搭团队内部的 Agent 技能体系，或者想给开源社区贡献 skill，这个工具链是当下最完整的工程化方案。
📦 怎么上手？
- 全局装 CLI：
npm install -g @skillscraft/cli - 程序化集成：
npm install @skillscraft/core - 官方文档：Agent Skills 规范说明
- 完整仓库（附 13 个 example skills）：github.com/Pratiyush/skill-sdk
说实话，这是我目前见过最认真做”Agent Skills 工程化”的 TypeScript 工具。社区还在早期，但方向很对——Skill 的质量比数量重要，这套工具就是来筛质量的。
评论区
登录后可评论。