skill-forge 是 AbsolutelySkilled 注册表的引导工具,用于从任意来源生成生产就绪的技能包。
用途
- 将 GitHub 仓库、文档 URL 或领域主题转化为结构完整的技能文件夹。
- 技能以文件夹形式组织,包含入口文件 SKILL.md 以及可选的参考文档、脚本、模板、数据文件等,供智能体按需读取和使用。
主要能力
- 支持 URL 输入研究:按优先级抓取 /llms.txt、README、/docs/、API 参考、指南、变更日志,并回答六个发现性问题以建立心智模型。
- 支持领域主题头脑风暴:通过交互式提问确定目标受众、范围、关键知识点、常见错误、子领域和输出格式,在用户批准范围后才开始撰写。
- 区分技能与智能体定义:技能是可移植的知识包,智能体定义是执行上下文;该工具只生成技能。
- 内置配置管理:首次运行检查 forge-config.json,询问默认输出目录、技能类型偏好和安装目标,并存储答案。
- 维护锻造历史:每次成功后向 forge-log.jsonl 追加记录,用于避免重复、参考先前模式、跟踪分类覆盖。
- 提供校验脚本 scripts/validate-skill.sh 检查结构和常见问题。
- 生成 evals.json(10-15 个评估用例)和可选的 sources.yaml。
- 支持多种安装位置:注册表 PR(skills/<name>/)、全局(~/.agents/skills/<name>/)、项目级跨客户端(.agents/skills/<name>/)、仅 Claude 项目(.claude/skills/<name>/)。
使用方式
- 斜杠命令:/skill-forge <url-or-topic>。
- 首次运行按提示选择输出目录、技能类型和安装目标。
- 输入为 URL 时进入研究阶段;输入为领域主题时进入头脑风暴阶段;模糊时询问用户。
- 撰写遵循渐进披露原则,SKILL.md 控制在约 300 行以内,详细内容放入 references/ 文件。
- 撰写完成后运行校验脚本,再按配置路径输出技能文件夹。
适用场景
- 为特定工具、API 或领域知识快速构建可复用的智能体技能包。
- 向 AbsolutelySkilled 注册表贡献技能。
- 在团队项目或个人全局环境中安装跨客户端技能。
限制
- 该工具生成的是技能而非智能体定义;若需要隔离上下文、特定工具权限或独立模型,应参考 Claude Code 的智能体文档。
- 技能质量高度依赖研究深度,研究未完成前不应撰写 SKILL.md。
- 领域技能若完全来自训练知识和用户输入,可省略 sources.yaml。
- 资料未提供具体收费、价格或平台兼容性之外的额外效果说明。