Skill Forge

Skill 规范检验、转换与优化工具链。

规范遵循 Agent Skills Specification 开放标准。

功能

• Validator（验证器）：验证 SKILL.md 是否符合 Agent Skills 标准
• Converter（转化器）：将插件、Agent、Workflow、自然语言转换为标准 SKILL.md
• Optimizer（优化器）：分析 Skill 质量并提供优化建议

安装

pip install -e .

使用方法

# 验证单个文件
skill-forge validate <path>

# 批量验证
skill-forge validate --batch <dir>

# 自然语言转换
skill-forge convert nl --input "创建一个代码审查技能"

# Agent 转换
skill-forge convert agent --input <path>

# 质量评分
skill-forge quality <path>

# 优化
skill-forge optimize <path> --level 2

项目结构

skill-forge/
├── src/skill_forge/           # 源代码
│   ├── skill_validator/       # 验证器
│   ├── skill_converter/       # 转化器
│   ├── skill_optimizer/       # 优化器
│   ├── llm/                   # LLM 集成
│   └── models/                # 数据模型
├── tests/                     # 测试
└── .claude/                   # Claude Code 集成

LLM 集成

skill-forge 不管理 LLM 调用，只暴露接口槽位。调用方可注入 LLM 能力：

from skill_forge.llm.slots import LLMCallable

def my_llm(system: str, user: str) -> str:
    # 调用你的 LLM
    return response

from skill_forge.skill_optimizer import SkillOptimizer
optimizer = SkillOptimizer()
result = optimizer.optimize("path/to/SKILL.md", llm=my_llm)

规范参考

完整规范见：

• SKILL-SPECIFICATION.md（英文）
• SKILL-SPECIFICATION.zh.md（中文）

许可证

MIT