Skip to content
Back to search

skillforge

SkillForge — AI Agent Skills Generator. A structured 4-step prompt system that forges production-grade Agent Skills from scratch.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mmlong818--skillforge/badge.svg)](/listings/mmlong818--skillforge)

HTML

<a href="/listings/mmlong818--skillforge"><img src="/api/listings/mmlong818--skillforge/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/mmlong818/skillforge.git
cd skillforge

pnpm install

cp .env.example .env
# 编辑 .env 填入数据库连接和 LLM 配置

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 235 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # SkillForge v1.5.1
  2. **AI Agent Skills 锻造炉** — 用 AI 自动锻造生产级 Agent Skills 的开源工具。
  3. [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
  4. ![Version](https://img.shields.io/badge/version-1.5.1-blue.svg)
  5. ---
  6. <p align="center">
  7. <img src="https://files.manuscdn.com/user_upload_by_module/session_file/309866237129684078/GLnMzhHYFmrcXYPw.png" alt="SkillForge Screenshot" width="700">
  8. </p>
  9. ---
  10. ## 这是什么
  11. SkillForge 是一个完整的 Web 应用,内置经过实战验证的 **4 步 Agent Skills 生成引擎**,严格对齐 [Anthropic 官方 Agent Skills 规范](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)。
  12. 它解决一个核心问题:**如何让 AI 模型生成真正可用的、符合官方最佳实践的 Agent Skill,而不是内容过长、格式错误、无法触发的半成品。**
  13. ---
  14. ## 核心功能
  15. | 功能 | 说明 |
  16. |------|------|
  17. | 一键生成 | 输入 Skill 名称和描述,自动执行 4 步生成流程 |
  18. | 修正优化 | 上传已有 Skill,3 步自动诊断并重写为最佳实践版本 |
  19. | 实时流式进度 | 每个步骤的输出实时流式展示,生成过程透明可见 |
  20. | 标记提取 | 使用 `%%SKILL_BEGIN%%` / `%%SKILL_END%%` 标记精确提取,杜绝截断 |
  21. | 完整 Skill 包 | SKILL.md + 可选配套资源文件 |
  22. | ZIP 下载 | 一键打包下载,即装即用 |
  23. | 任务控制 | 支持取消运行中的任务、重试失败步骤、删除历史记录 |
  24. ---
  25. ## 两大模式
  26. ### 创建新 Skill — 4 步生成流程
  27. | 步骤 | 名称 | 核心作用 |
  28. |------|------|----------|
  29. | Step 1 | 内容规划 | 分析 Skill 定位、触发场景、知识缺口、资源文件需求 |
  30. | Step 2 | SKILL.md 生成 | 生成符合官方规范的 SKILL.md(30-150 行,≤200 行上限) |
  31. | Step 3 | 资源文件生成 | 按规划生成 scripts/、references/ 等配套文件 |
  32. | Step 4 | 使用说明 | 生成安装指引、触发示例和验证清单 |
  33. ### 修正已有 Skill — 3 步优化流程
  34. | 步骤 | 名称 | 核心作用 |
  35. |------|------|----------|
  36. | Step 1 | 问题诊断 | 对照最佳实践逐项检查,输出诊断报告 |
  37. | Step 2 | SKILL.md 重写 | 保留原始意图,按最佳实践重写完整 SKILL.md |
  38. | Step 3 | 质量审计 | 验证重写质量,确保优于原版 |
  39. 支持文本粘贴和 .md 文件上传两种输入方式。
  40. ---
  41. ## 版本历史
  42. | 版本 | 日期 | 主要变更 |
  43. |------|------|----------|
  44. | v1.5.1 | 2026-07-01 | 安全加固:资源文件提取拒绝绝对路径 / 盘符 / 含 `..` 的路径,防止下载包被 Zip-Slip 写出目标目录(新增回归测试) |
  45. | v1.5 | 2026-07-01 | 生成流程新增「Skill 资格判定」门(Step 1,先判断该不该做成 Skill);description 生成升级为触发评测驱动(Step 3 先构造 should / should-not / near-neighbor 触发测试集并实测选优,实测优先于自评分) |
  46. | v1.4 | 2026-04-03 | 重构为 4 步流程对齐官方规范;标记提取彻底解决 SKILL.md 截断;实时流式进度展示;支持 Claude CLI / Anthropic API 后端 |
  47. | v1.3 | 2026-04-02 | 修正部分情况下 SKILL.md 不完整;允许历史任务重置 |
  48. | v1.2 | 2026-03-12 | 新增「修正已有 Skill」功能(3 步优化流程);重写全部提示词 |
  49. | v1.1 | 2026-03-11 | 新增任务取消/删除功能;修复部署问题 |
  50. | v1.0 | 2026-03-10 | 首个版本:生成引擎、实时进度、ZIP 下载、历史记录 |
  51. ---
  52. ## 技术栈
  53. | 层 | 技术 |
  54. |---|------|
  55. | 前端 | React 19 + Tailwind CSS 4 + shadcn/ui |
  56. | 后端 | Express 4 + tRPC 11 |
  57. | 数据库 | MySQL / TiDB(Drizzle ORM) |
  58. | LLM | Claude CLI / Anthropic API / OpenAI-compatible API |
  59. ---
  60. ## 快速开始
  61. ### 前置条件
  62. - Node.js 22+
  63. - pnpm
  64. - MySQL 或 TiDB 数据库
  65. - LLM 后端(三选一,见下方配置)
  66. ### 安装
  67. ```bash
  68. git clone https://github.com/mmlong818/skillforge.git
  69. cd skillforge
  70. pnpm install
  71. cp .env.example .env
  72. # 编辑 .env 填入数据库连接和 LLM 配置
  73. ```
  74. ### 数据库初始化
  75. 按顺序执行 `drizzle/` 目录下的迁移文件:
  76. ```bash
  77. mysql -u user -p skillforge < drizzle/0000_striped_iron_man.sql
  78. mysql -u user -p skillforge < drizzle/0001_legal_thor.sql
  79. mysql -u user -p skillforge < drizzle/0002_supreme_gabe_jones.sql
  80. mysql -u user -p skillforge < drizzle/0003_wet_vance_astro.sql
  81. mysql -u user -p skillforge < drizzle/0004_concerned_mattie_franklin.sql
  82. ```
  83. ### 启动
  84. ```bash
  85. # 开发模式
  86. pnpm dev
  87. # 生产构建
  88. pnpm build
  89. node dist/index.js
  90. ```
  91. 访问 `http://localhost:3000` 即可使用。
  92. ---
  93. ## LLM 配置
  94. 支持三种后端,按优先级选择其一:
  95. ### 方式一:Claude CLI(本地订阅,推荐)
  96. ```env
  97. CLAUDE_CLI=true
  98. CLAUDE_CLI_PATH=claude # Windows 示例:C:\Users\xxx\AppData\Roaming\npm\claude.cmd
  99. ```
  100. 需已安装并登录 [Claude Code CLI](https://claude.ai/code)。
  101. ### 方式二:Anthropic API Key
  102. ```env
  103. ANTHROPIC_API_KEY=sk-ant-xxxxx
  104. LLM_MODEL=claude-sonnet-4-6 # 可选,默认 claude-sonnet-4-6
  105. ```
  106. ### 方式三:OpenAI-compatible API
  107. ```env
  108. BUILT_IN_FORGE_API_URL=https://api.openai.com
  109. BUILT_IN_FORGE_API_KEY=sk-xxxxx
  110. LLM_MODEL=gpt-4o
  111. ```
  112. 支持 OpenAI、DeepSeek、Together AI、Ollama 等任何兼容 `/v1/chat/completions` 的提供商。
  113. ---
  114. ## 本地开发
  115. 无需 OAuth 服务器,启用 `LOCAL_DEV` 模式即可直接以管理员身份访问:
  116. ```env
  117. LOCAL_DEV=true
  118. ```
  119. ---
  120. ## 项目结构
  121. ```
  122. skillforge/
  123. ├── README.md
  124. ├── LICENSE
  125. ├── CONTRIBUTING.md
  126. ├── skill/ # Manus Skill(轻量版,无需部署)
  127. │ ├── SKILL.md
  128. │ └── references/
  129. │ └── step-prompts.md
  130. ├── client/ # 前端 React 应用
  131. │ └── src/
  132. │ ├── pages/ # Home, Generate, History
  133. │ └── components/
  134. ├── server/ # 后端 Express + tRPC
  135. │ ├── skillEngine.ts # 4 步生成引擎
  136. │ ├── fixEngine.ts # 3 步修正引擎
  137. │ ├── prompts.json # 提示词配置
  138. │ ├── routers.ts
  139. │ └── db.ts
  140. ├── drizzle/ # 数据库 Schema 和迁移
  141. └── shared/ # 前后端共享类型
  142. ```
  143. ---
  144. ## Skill 质量标准
  145. SkillForge 生成的每个 Skill 严格对齐 Anthropic 官方规范:
  146. | 维度 | 要求 |
  147. |------|------|
  148. | 格式规范 | YAML frontmatter 包含 `name` 和 `description`;name 为 hyphen-case |
  149. | 简洁度 | SKILL.md 正文 30-150 行,上限 200 行;不包含 AI 已知常识 |
  150. | 描述质量 | description 第三人称,包含触发场景,≤200 词 |
  151. | 渐进式披露 | 详细内容拆分到 `references/`,主文件保持轻量 |
  152. | 代码优先 | 工作示例 snippet 优于文字描述 |
  153. ---
  154. ## 许可证
  155. 本项目采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可证。
  156. | 允许 | 不允许 |
  157. |------|--------|
  158. | 个人学习和使用 | 商业用途 |
  159. | 修改和二次创作 | 不注明出处 |
  160. | 非商业性分享和传播 | 使用更宽松的许可证再发布 |
  161. 如需商业授权,请联系作者。
  162. ---
  163. ## 作者
  164. **猫叔** — AI 技术专家
  165. 与 Claude Code 协作构建。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.