skill-creator 使用指南

skill-creator 是用来创建、编辑、审计、整理、验证 Skill 文件和 SKILL.md 的工具。

📁 Skill 标准目录结构

📝 SKILL.md 标准格式

---
name: skill-name
description: "简短描述：做什么的"
---

# 标题

使用说明正文...

## 工作流程

1. 步骤一
2. 步骤二
3. 步骤三

Frontmatter 规范：

• name + description 是必须项

• description 必须加引号

• 描述要简洁，用名词短语

🛠️ 常用场景

1️⃣ 创建新 Skill

python skills/skill-creator/scripts/init_skill.py skills/<新skill名称>

2️⃣ 打包 Skill

python skills/skill-creator/scripts/package_skill.py skills/<skill名称>

3️⃣ 验证 Skill 格式

python skills/skill-creator/scripts/quick_validate.py skills/<skill名称>

或用 Python 脚本批量验证：

python - <<'PY'
from pathlib import Path
import yaml

for p in Path("skills").glob("*/SKILL.md"):
    text = p.read_text()
    if not text.startswith("---\n"):
        raise SystemExit(f"缺少frontmatter: {p}")
    fm = text.split("---", 2)[1]
    yaml.safe_load(fm)
print("ok")
PY

✏️ 编辑 Skill 规范流程

1. 读取现有 Skill 和相关资源

2. 删除模型已知的通用建议

3. 保留脆弱的命令语法、认证注意事项、安全规则

4. 精简表格（除非表格确实必要）

5. 精练正文，用短句即可

6. 验证 frontmatter 并运行脚本测试