Docsbook
概要

docs-skills：ドキュメント上のAIエージェント向けモジュール型機能

2026年、AIエージェントはドキュメントを読むだけではありません。ドキュメントに対してアクションを実行します。ドキュメントサイトを公開したり、壊れたリンクを修正したり、llms.txtを生成したり、不足しているページを作成したり、アクセシビリティを監査したりします。こうしたアクションの実行方法を知る手段が「スキル」です。スキルとは、パッケージ化され、発見可能で、宣言的に記述された機能です。

この記事では、スキルとは何か、Docsbookのオープンソースカタログに現在何が含まれているか、そしてこのレイヤーがMCPとコンテンツの間にどのように位置付けられるかを説明します。

要約#

  • 「スキル」とは、機能（何を実行するか、いつトリガーするか、必要なツール）を説明するフロントマター付きのSKILL.mdファイルです
  • AIエージェント（Claude Code、Cursor）はスキルを読み取り、自律的に実行します
  • docs-skillsは、4つのドキュメントスキルを収録したオープンソースカタログです
  • Docsbook MCPはfind_skillを公開し、エージェントが実行時にクエリでスキルを検出できるようにします
  • スキルをローカルにインストールする（npx docs-skills install）か、MCP経由で使用できます

スキルの概要#

最小限の SKILL.md:

---
name: docs-pr-check
description: Validate documentation changes in a pull request — check for broken links, missing frontmatter, accessibility issues, and SEO regressions. Use when reviewing docs PRs.
category: automation
mode: agent
keywords: [pull request, broken links, frontmatter, review]
requires_docsbook_mcp: true
version: 1
---
 
# docs-pr-check
 
When the user opens a docs PR, run this skill to validate the change.
 
Steps:
 
1. Run `doc_search_unresolved` to find broken links in changed files
2. Verify YAML frontmatter on every new or modified `.md` file
3. Check that internal links resolve
4. Suggest improvements
 
Tools used: `doc_search_unresolved`, `doc_outline`, `doc_resolve_link` (Docsbook MCP)

上記のスキルは形式を示す例であり、カタログのエントリではありません。実際の4つのスキルは後述します。frontmatter フィールドは、スキーマで実際に定義されている name、description、category、mode、keywords、requires_docsbook_mcp、version です。

frontmatter は契約です。本文はプロンプトです。

ドキュメントにとってこれが重要な理由#

スキルが解決する3つの問題：

1. 機能の発見性#

スキルがなければ、ドキュメントを読むAIエージェントは何をすべきか推測しなければなりません。スキルがあれば、エージェントはfind_skill("audit my docs")を呼び出し、正確な手順が記載されたSKILL.mdを取得します。

2. モジュールの再利用#

あるプロジェクト向けに書かれたスキルは、あらゆるプロジェクトで機能します。docs-manage は、ページの記述とそのページが属するサイトの運用に関するルールブックであり、Docsbook上かどうかを問わず、あらゆるドキュメントリポジトリに適用されます。

3. 構成#

スキルは増やすのではなく、組み合わせて構成します。それぞれが、タスクで必要になった場合にのみ読み込む、焦点を絞ったドキュメントの references/ ディレクトリを備えています。docs-manage だけでも、取得、変換、執筆のルール用に別々の参照を保持しています。エージェントはスキルを読み、カタログを読み込むのではなく、必要な参照を1つだけ読みます。

docs-skillsカタログ#

docs-skillsカタログには何がありますか？#

docs-skillsは、4つのスキルから成るオープンソースのカタログで、それぞれドキュメントに対してエージェントが行う1つの作業を扱います。以前は細分化されたスキルの長いリストでしたが、互いによく似た説明が50個もある中からエージェントが選ぶと適切に選択できないため、4つの作業に整理されました。

スキル 行う作業
docs-create 存在しなかったドキュメントを作成する — プロダクトのウェブサイト、コードリポジトリ、移行元の別のドキュメントプラットフォーム、またはプロダクト名だけをもとに作成します
docs-analyze すでに存在するドキュメントの問題を見つけて修正する。検索順位、AI回答のシグナル、読者の行動、ファネルを出発点にします
docs-manage ページの作成方法と、そのページが置かれるサイトの運用方法に関するルールブック — ページタイプ、構造、スタイル、対象読者、検索性、コンバージョン
docs-automate 誰かが覚えていなくても継続して実行されるべきことを設定する — 差分ガード、翻訳トリガー、リリース告知

各スキルは、GitHubリポジトリ内に単独で存在する SKILL.md であり、エージェントが必要に応じて読み込む references/ ディレクトリを備えています。機械可読なインデックスは同じリポジトリ内の index.json です。上記の数は、2026-09-03にそこから読み取ったものです。

スキルを使用する2つの方法#

ローカルインストール#

npx docs-skills install

カタログを.claude/skills/、.cursor/rules/、またはAGENTS.mdにコピーします（検出されたツールによって異なります）。オフラインで動作します。docs-skills updateで更新します。

このパターンでは、ツールのスキルがリポジトリ内に存在し、バージョン管理されます。

MCP を介した実行時の検出#

Docsbook MCP が接続されている場合、エージェントは次を呼び出します：

find_skill({ query: "audit my docs for SEO and accessibility" })

各 SKILL.md に対して raw_url とともに、最も一致するスキルを返します。エージェントはそれらを取得し、指示に従います。

このパターンには、ローカルへのインストールが不要で、常に最新バージョンを使用でき、マシン間で動作するという利点があります。

AIエージェントが実際にスキルを活用する方法#

私たちが目にした3つの実際のワークフロー：

ワークフロー 1: PRレビュー#

開発者が docs/ に関わるPRを作成します。開発者のClaude Code（またはCursor）が docs-pr-check を呼び出します。このスキルは次の処理を行います。

  1. 変更された .md ファイルを一覧表示する
  2. 各ファイルに対して doc_search_unresolved を呼び出す
  3. フロントマターが完全か確認する
  4. 結果をPRコメントとして報告する

開発者は人間のレビュアーより先にレポートを確認できます。多くのドキュメントに関する問題は、チームに届く前に解決されます。

ワークフロー 2：古いコンテンツの検出#

ユーザーのセットアップにおける週次 cron が docs-stale-watcher を呼び出します。このスキルは次の処理を行います。

  1. トラフィックはあるものの、90日以上編集されていないページを Docsbook analytics で検索する
  2. ドキュメントグラフと相互参照する
  3. 更新候補を一覧表示する

出力は更新対象ページのバックログです。つまり、収益シグナルのあるコンテンツギャップです。

ワークフロー 3：AI チャットのチューニング#

ユーザーが「AI チャットが機能 X について幻覚を起こしている」と言います。エージェントは docs-tune-ai-chat を呼び出します。このスキルは次の処理を行います：

  1. get_ai_questions を呼び出して、最近の未回答のクエリを確認する
  2. get_negative_feedback を呼び出して、低評価のパターンを確認する
  3. 不足している、または不十分なコンテンツを特定する
  4. 新しいページまたはシステムプロンプトの変更を提案する

これは「エージェントがエージェントを改善する」ループです。

スキル + MCP: アーキテクチャ#

スキルはエージェントに何をすべきかを伝えます。MCPツールはエージェントにどう実行するかを伝えます。

  • スキルは「すべてのページのアクセシビリティを監査する」と指示します
  • スキル本文には「doc_list_pagesを呼び出し、その後それぞれに対してdoc_outlineを呼び出す」のような手順が記載されています
  • MCPはスキルが呼び出す実際のツールを公開します

どちらも単独では十分ではありません。組み合わせることで、発見（find_skill）→ 手順（SKILL.md）→ 実行（MCPツール）という完全なループが形成されます。

自分のドキュメントではこのようになります#

開発者向け製品を提供していて、AIエージェントにドキュメントを適切に扱わせたい場合は、3つの手順があります。

  1. llms.txt を備えたプラットフォームで公開する — Docsbook はワークスペースごとに1つを自動生成します
  2. MCPサーバーを公開するか、プラットフォームのものに依存する — Docsbook MCP が含まれています
  3. 関連する docs-skills をローカルにインストールする — npx docs-skills install

その後は、どのエージェント（Claude Code、Cursor、HTTP MCPを使用するChatGPT）でも、ドキュメントを自律的に扱えるようになります。

独自のスキルを作成する#

カタログにないドキュメントワークフローがある場合は、それを提供してください。SKILL.md 形式はシンプルで、カタログは公開されており、貢献内容は数日で反映されます。

有用なスキルの条件：

  • 具体的である（1つの仕事を適切にこなす）
  • 組み合わせ可能である（既存の MCP ツールを呼び出す）
  • 明確なユーザーの意図によってトリガーされる
  • 例を用いて文書化されている

リポジトリには SKILL.md テンプレートと貢献ガイドがあります。

Docsbook は docs-skills をサポートしています。ランタイムでの検出には find_skill MCP ツールを、ローカルコピーには npx docs-skills install を使用します。ワークスペースを公開すると MCP エンドポイントが付属します。セットアップ手順は docsbook.io/mcp にあります。

無料で始める — クレジットカード不要

次のステップ#

このページは役に立ちましたか？

提供： Docsbook