Skill Doc Generator

skill-doc-generator

可将任意文档 URL 转换为 Claude Code 技能文件的 MCP 服务，并内置完整的 skill-creator 工作流，让任何 Agent 无需安装额外内容即可创建、测试和迭代技能。无需 API 密钥。

工具

该服务提供五种工具。AI Agent（Claude Code、Cursor、Windsurf 或任何兼容 MCP 的 IDE）负责所有推理：

工具	描述
fetch_doc_page(url)	获取文档页面，剔除导航、脚本和样式，并返回纯净文本以及所有同域链接。
fetch_github_repo(repo, paths?)	通过 GitHub API 获取 GitHub 仓库中的关键文件（README、文档、示例）。对于内嵌文档完善的仓库，这比抓取 HTML 更可靠。设置 GITHUB_TOKEN 环境变量可避免速率限制。
save_skill(content, skill_name, output_dir?)	将生成的技能 Markdown 写入磁盘，路径为 <output_dir>/skills/<skill_name>/SKILL.md。
read_skill(skill_name, output_dir?)	从磁盘读取现有技能。更新技能前先调用此工具获取其当前内容，然后调用 save_skill 保存合并后的结果。
get_skill_creator(section?)	返回内置的 skill-creator 说明。不传参数 → 主 SKILL.md。传入 section URI 可加载子 Agent 文件（grader、comparator、analyzer）或 JSON 架构参考。

Agent 会决定要抓取哪些页面，将内容整合成技能并保存。服务本身不会调用外部 AI API。

MCP 资源

该服务还将 skill-creator 文件作为 MCP 资源提供给支持原生资源读取的客户端：

URI	内容
skill-creator://SKILL.md	完整的 skill-creator 工作流说明
skill-creator://agents/grader.md	Grader 子 Agent — 根据对话记录评估断言
skill-creator://agents/comparator.md	Blind comparator 子 Agent — 在不知道来源的情况下比较两个输出
skill-creator://agents/analyzer.md	事后分析器 — 解释胜出版本优于另一个版本的原因
skill-creator://references/schemas.md	evals.json、grading.json、benchmark.json 的 JSON 架构参考

安装

需要 Node.js 18+。无需克隆，可直接从 npm 安装。

Claude Code（全局 — 适用于所有项目）：

claude mcp add --transport stdio --scope user skill-doc-generator npx skill-doc-generator

其他 Agent IDE — 添加到 MCP 配置中：

{
  "mcpServers": {
    "skill-doc-generator": {
      "command": "npx",
      "args": ["skill-doc-generator"]
    }
  }
}

Cursor：.cursor/mcp.json · Windsurf：~/.codeium/windsurf/mcp_config.json · VS Code (Copilot)：.vscode/mcp.json

如果你更喜欢永久全局安装：

npm install -g skill-doc-generator
claude mcp add --transport stdio --scope user skill-doc-generator skill-doc-generator

用法

根据文档生成技能

注册服务后，只需向 Agent 提出请求：

Generate a skill from https://laravel.com/docs/13.x/eloquent

Create a Claude Code skill from the Stripe API docs: https://stripe.com/docs/api

Build a skill from https://docs.python.org/3/library/asyncio.html and save it to ./skills

Generate a skill from https://github.com/expressjs/express

Agent 将会：

• 获取初始页面（或 GitHub 仓库）并检查可用内容
• 决定值得继续抓取哪些页面（快速入门、API 参考、关键概念）
• 生成包含前置元数据、关键概念、常见操作、模式和快速参考的技能 .md 文件
• 默认将其保存到 ~/.claude/skills/（也可以询问你要保存到哪里）

更新现有技能

Update my laravel-eloquent skill with the latest docs

Agent 会读取现有技能、获取更新后的文档，并保存合并版本。

使用 skill-creator 创建或改进技能

该服务内置完整的 skill-creator 工作流。调用 get_skill_creator 获取说明，然后按以下循环操作：起草 → 测试 → 审查 → 改进 → 重复。

Use the skill-creator to help me build a skill for X

I want to improve an existing skill — use skill-creator to run evals and iterate

内置的 skill-creator 涵盖：

• 明确意图并撰写 SKILL.md 初稿
• 编写测试用例并运行测试（使用和不使用该技能），由并行子 Agent 执行
• 根据量化断言对输出进行评分
• 启动 eval 查看器供人工审查
• 根据反馈迭代
• 优化技能描述，提高触发准确率

输出格式

生成的技能文件遵循 Claude Code 技能格式：

---
name: laravel-eloquent
description: Use when working with Laravel Eloquent ORM — models, relationships, queries, scopes
---

# Laravel Eloquent

...actionable instructions for the agent...

保存的文件可立即作为 Claude Code 技能使用。

要求

• Node.js 18+
• 兼容 MCP 的 Agentic IDE（Claude Code、Cursor、Windsurf 等）
• 无需 API 密钥

项目结构

src/
  index.ts                    — stdio MCP server entry point
  tools/
    generate-skill.ts         — fetch_doc_page, fetch_github_repo, save_skill, read_skill tools
  resources/
    skill-creator.ts          — get_skill_creator tool + MCP resources
bundled-skills/
  skill-creator/
    SKILL.md                  — main skill-creator instructions
    agents/                   — grader, comparator, analyzer subagent files
    references/               — JSON schema reference