Skill Doc Generator

skill-doc-generator

任意のドキュメント URL を Claude Code のスキルファイルに変換する MCP サーバーです。skill-creator のワークフロー全体もバンドルしているため、追加のインストールなしで、あらゆるエージェントがスキルを作成、テスト、反復改善できます。API キーは不要です。

ツール

サーバーは 5 つのツールを公開します。推論はすべて AI エージェント（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 を渡すと、サブエージェントファイル（grader、comparator、analyzer）または JSON スキーマのリファレンスを読み込みます。

クロールするページの選択、内容のスキルへの統合、保存はエージェントが行います。サーバー内部で外部 AI API を呼び出すことはありません。

MCP リソース

ネイティブのリソース読み込みに対応したクライアント向けに、サーバーは skill-creator のファイルも MCP リソースとして公開します。

URI	内容
skill-creator://SKILL.md	skill-creator のワークフロー全体の説明
skill-creator://agents/grader.md	grader サブエージェント — トランスクリプトに対するアサーションを評価します
skill-creator://agents/comparator.md	ブラインド比較サブエージェント — 出力元を知らずに 2 つの出力を判定します
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

その他のエージェント対応 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

使い方

ドキュメントからスキルを生成する

サーバーを登録したら、エージェントに次のように依頼するだけです。

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

エージェントは次の処理を行います。

• 最初のページ（または GitHub リポジトリ）を取得し、利用可能なコンテンツを確認します
• クロールする価値のある追加ページ（クイックスタート、API リファレンス、主要な概念）を判断します
• フロントマター、主要な概念、一般的な操作、パターン、クイックリファレンスを含むスキルの .md を生成します
• デフォルトでは ~/.claude/skills/ に保存します（または保存先を尋ねます）

既存のスキルを更新する

Update my laravel-eloquent skill with the latest docs

エージェントは既存のスキルを読み込み、更新されたドキュメントを取得して、マージしたバージョンを保存します。

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 の下書きを作成する
• テストケースを書き、並列サブエージェントとしてスキルあり・なしの両方でテストを実行する
• 定量的なアサーションに基づいて出力を採点する
• 人間がレビューするための評価ビューアーを起動する
• フィードバックに基づいて反復改善する
• トリガー精度を高めるために、スキルの説明を最適化する

出力形式

生成されるスキルファイルは 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 互換のエージェント型 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