用途:为 dev-skills 库创建某项技术的文档技能。每个技能是与智能体无关的薄封装:指向官方实时文档,并附上一小层精选最佳实践,只收录智能体默认容易做错的点。技能统一采用两层结构——实时文档指针加精选最佳实践,模板见 references/skill-template.md 中的 SKILL.md。
主要流程:先判断文档来源类型。若技术提供 llms.txt,优先使用;否则优先官方文档网站而非 GitHub 仓库;没有文档网站时才用仓库 README/docs。
初始化:python scripts/init_skill.py <technology-name> --path <output-directory>,技术名用 kebab-case(如 bun、hono、better-auth、rustfs),不加 -docs 后缀。
接着根据来源类型启动 Explorer 智能体读取文档,要求不总结,而是找出:开发者常被 npm/外部包替代的内置能力、来自相似技术时不易察觉的模式或 API、容易忽略且文档未突出的常见错误。
筛选标准:只有同时满足“智能体默认会做错”“文档未显著覆盖”“不易过时”三条才收录。文档已讲清的、随项目变化的观点、绑定小版本的内容应跳过。最后按模板写技能并打包:cd scripts/ 后执行 python package_skill.py <path/to/skill-folder>。
安装位置:技能与智能体无关,同一文件夹可放入 .claude/skills/(Claude Code)和 .agents/skills/(Gemini、OpenAI 等)。
限制:资料未提供关于收费、价格、平台支持范围或具体技术覆盖清单的信息;实际生成效果依赖被读取文档的公开内容。