用途:SciAgent Skill Creator 是本仓库内的脚手架工具,把 AGENTS.md 步骤 1、2、4、5、6 中的样板工作自动化,让编写者把精力放在内容(When to Use、Workflow、Recipes、References)而非字段管道上。适用于用户要求为某个工具、库、数据库或指南主题新增 SciAgent 技能条目,或直接调用 /sciagent-skill-creator,或代理本要手改 registry.yaml 并新建 skills/<cat>/<name>/SKILL.md 时使用。编辑已有条目内容、迁移已有条目、仅更新 registry.yaml 时不适用。
使用前需收集(通过对话,不用隐藏参数):主题(具体工具/库/概念名,模糊主题需追问)、子类型(pipeline | toolkit | database | guide)、分类目录、条目名(kebab-case,惯例 {tool-name}-{purpose})、许可证(默认原创文字内容为 CC-BY-4.0)、描述(1-2 句,最多 1024 字符,前 120 字符内出现工具/领域关键词)、可选标签。脚手架前先查重:grep -i "<topic-keyword>" registry.yaml 和 ls legacy/ | grep -i "<topic-keyword>"。
运行方式:脚本非交互,由代理提供全部参数:python .claude/skills/sciagent-skill-creator/scripts/scaffold.py --sub-type pipeline --category genomics-bioinformatics --name my-tool-purpose --description "..." --license MIT --tags databases,literature。脚本会校验名称、分类目录、描述与标签,按模板生成 SKILL.md,向 registry.yaml 追加条目(date_added 为当日 UTC),运行 pixi run validate;任一校验失败则中止且不写入。生成后需补齐 Overview、Workflow、Recipes 等章节,并运行 pixi run test。内容写作上不写入配色、字体、dpi、一次性分析的硬编码路径等个性化选择,保持简洁、以代码为主。文件包含 SKILL.md、scripts/scaffold.py、scripts/validate_description.py。失败模式包括名称已存在、分类不在列表、描述以 stop-verb 开头、描述过长、validate 失败。