Skill Forge

Transform any document into a production-ready Claude skill.

Skill Forge 是一个 meta-skill —— 一个能够将任何文档、教程、指南转化为高质量 Claude skill 的工具。

为什么需要 Skill Forge？

Claude Code 的 skill 系统非常强大，但手动创建 skill 需要：

• 理解 skill 的文件格式和结构
• 遵循最佳实践（触发条件、checklist、示例等）
• 手动安装和配置

Skill Forge 解决了这些问题：只需提供文档，自动生成符合最佳实践的 skill。

功能特性

• 多源输入 - 本地文件、粘贴文本、URL、整个文件夹
• 智能转换 - 自动分析内容结构，选择最佳模板
• 最佳实践 - 生成的 skill 自动遵循 Claude 官方规范
• 对话微调 - 生成后可继续调整优化
• 一键安装 - 自动安装到 ~/.claude/skills/

安装

方法 1：一键安装（推荐）

# 克隆项目
git clone https://github.com/HelloSanshi/skill-forge.git
cd skill-forge

# 运行安装脚本
./install.sh

方法 2：手动安装

# 创建 skill 目录
mkdir -p ~/.claude/skills/skill-forge

# 复制文件
cp -r SKILL.md templates/ examples/ ~/.claude/skills/skill-forge/

方法 3：直接下载

# 创建目录并下载
mkdir -p ~/.claude/skills/skill-forge
curl -L https://github.com/HelloSanshi/skill-forge/archive/main.tar.gz | tar -xz --strip-components=1 -C ~/.claude/skills/skill-forge

验证安装

安装完成后，skill 会自动激活。你可以通过以下方式验证：

# 检查文件是否存在
ls ~/.claude/skills/skill-forge/SKILL.md

使用方法

安装后，在 Claude Code 中直接对话即可使用：

转换本地文件

把 ./docs/api-guide.md 转成 skill

转换粘贴内容

把这个转成 skill：

# Git Commit 规范
1. 使用 feat/fix/docs 等前缀
2. 主题行不超过 50 字符
3. 使用祈使句
...

转换 URL

Create a skill from https://docs.example.com/best-practices

批量转换

Convert all markdown files in ./documentation/ to skills

工作流程

输入文档 → 内容分析 → 模板选择 → 生成预览 → 用户微调 → 安装激活
    │          │          │           │           │          │
    ▼          ▼          ▼           ▼           ▼          ▼
  文件/URL   识别类型   4种模板    显示预览    对话调整   自动安装
  粘贴文本   提取结构   自动匹配   可以修改    可以迭代   即刻可用

模板类型

Skill Forge 内置 5 种模板，根据内容自动选择：

模板	适用场景	特点
Tutorial	教程、学习指南、操作手册	渐进式步骤、验证点
Rules	编码规范、风格指南、策略	Do/Don't 示例、规则列表
Checklist	审查流程、QA 步骤、发布检查	可勾选项、验证标准
Workflow	多步流程、决策树、管道操作	阶段划分、分支处理
Multi-Agent	多模型协作、任务分配、Agent编排	能力矩阵、依赖管理、交接文档

微调命令

生成预览后，你可以继续对话调整：

命令	效果
确认 / 安装	安装 skill 到 ~/.claude/skills/
改名为 xxx	修改 skill 名称
用 checklist 模板	切换到其他模板
加上 xxx 部分	添加特定内容
把 xxx 删掉	移除特定部分
更详细一点	扩展内容
精简一下	压缩内容
重新生成	从头开始

项目结构

skill-forge/
├── SKILL.md              # 核心 skill 定义文件
├── templates/            # 内置模板库
│   ├── tutorial.md       # 教程模板
│   ├── rules.md          # 规则模板
│   ├── checklist.md      # 检查清单模板
│   └── workflow.md       # 工作流模板
├── examples/             # 转换示例
│   ├── input-sample.md   # 示例：输入文档
│   └── output-sample.md  # 示例：生成的 skill
├── install.sh            # 一键安装脚本
└── README.md             # 本文件

生成的 Skill 遵循的最佳实践

Skill Forge 生成的每个 skill 都自动遵循 Claude 官方最佳实践：

结构规范

• 正确的 YAML frontmatter（name, description）
• 清晰的触发条件（何时使用）
• 分层组织（概览 → 步骤 → 细节）

内容规范

• 可追踪的 Checklist
• 边界条件说明（何时不适用）
• 具体的示例（好的/坏的对比）
• 错误处理指引

可执行性

• 步骤是可操作的动作，不是模糊描述
• 每个步骤有验证方式

常见问题

Q: Skill 安装后没有生效？

确认文件位置正确：

ls ~/.claude/skills/skill-forge/SKILL.md

Q: 如何卸载？

rm -rf ~/.claude/skills/skill-forge

Q: 支持哪些输入格式？

• Markdown (.md)
• 纯文本 (.txt)
• PDF（自动提取文字）
• 网页 URL（自动抓取内容）

Q: 生成的 skill 太长/太短？

使用微调命令：

• 精简一下 - 压缩内容
• 更详细一点 - 扩展内容

发布你的 Skill

分享到社区

1. 创建 GitHub 仓库，包含：

   • SKILL.md - 核心 skill 文件
   • install.sh - 安装脚本
   • README.md - 使用说明

2. 在社区分享：

   • Claude 官方论坛
   • GitHub Discussions
   • 技术社区

申请官方市场

如果你的 skill 足够成熟，可以申请加入 Claude 官方插件市场：

1. 确保 skill 质量：

   • 完整的文档
   • 清晰的使用示例
   • 稳定的功能

2. 通过 Claude Code 的 /feedback 命令提交申请

3. 等待 Anthropic 团队审核

注：目前官方插件市场没有公开的自助发布系统，需要通过申请流程。

贡献指南

欢迎贡献！你可以：

1. 添加新模板 - 在 templates/ 目录添加新模板
2. 改进转换逻辑 - 优化 SKILL.md 中的转换规则
3. 增加示例 - 在 examples/ 添加更多转换案例
4. 修复问题 - 提交 Issue 或 PR

开发流程

# Fork 并克隆
git clone https://github.com/HelloSanshi/skill-forge.git

# 创建分支
git checkout -b feature/your-feature

# 修改并测试
./install.sh
# 在 Claude Code 中测试

# 提交
git commit -m "feat: add your feature"
git push origin feature/your-feature

# 创建 Pull Request

相关资源

• Claude Code 官方文档
• Skill 最佳实践指南
• Claude 社区

License

MIT License - 详见 LICENSE 文件

---

Skill Forge - 让每份文档都成为 AI 的超能力。