✍️ ライティングコミュニティ

docs-knowledge-base

技術ドキュメントを、人が理解しやすいようにmdbook形式で作成・更新し、ドキュメントやナレッジベースの章を整理することで、より分かりやすい情報を提供するSkill。

📜 元の英語説明(参考)

Create or update docs/knowledge-base/ chapters in mdbook format for human-first technical documentation.

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o docs-knowledge-base.zip https://jpskill.com/download/10388.zip && unzip -o docs-knowledge-base.zip && rm docs-knowledge-base.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/10388.zip -OutFile "$d\docs-knowledge-base.zip"; Expand-Archive "$d\docs-knowledge-base.zip" -DestinationPath $d -Force; ri "$d\docs-knowledge-base.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して docs-knowledge-base.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → docs-knowledge-base フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

[Skill 名] docs-knowledge-base

docs/knowledge-base/ 以下のファイルを作成または編集する際は、このワークフローを使用してください。

対象読者とトーン

主要な対象読者: 人間のメンテナーおよびコントリビューター。
二次的な対象読者: プロジェクトドキュメントを読み込む AI エージェント。
簡潔で事実に基づいた文章を記述してください。
AI 固有のアノテーションやプロンプト指向のフォーマットは避けてください。

mdbook の構造

章のソースは docs/knowledge-base/src/ 以下に保持してください。
docs/knowledge-base/src/SUMMARY.md をナビゲーションの信頼できる情報源として保持してください。
新しい章を追加する際は、同じ変更で SUMMARY.md を更新してください。

章の形式

1 つの章につき、トップレベルの見出し (#) は 1 つにしてください。
明示的な責任、不変条件、およびワークフローを持つ短いセクションを推奨します。
関連する用語は glossary.md にリンクしてください。
具体的な主張を行う場合は、関連するコードパスへのリンクを貼ってください。

記述規則

文章にはセマンティックな改行を使用してください。
能動態と操作的な言い回しを推奨します。
ガイダンスは、リポジトリ固有のパスである場合を除き、実装に依存しないようにしてください。
事実、制約、および推奨事項を明確に区別してください。

検証

完了する前に、書籍をビルドし、正確なコマンドと結果を報告してください。

mdbook build docs/knowledge-base/

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Use this workflow when creating or editing files under docs/knowledge-base/.

Audience and tone

Primary audience: human maintainers and contributors.
Secondary audience: AI agents reading project documentation.
Write concise, factual prose.
Avoid AI-specific annotations or prompt-oriented formatting.

mdbook structure

Keep chapter sources under docs/knowledge-base/src/.
Keep docs/knowledge-base/src/SUMMARY.md as the navigation source of truth.
When adding a new chapter, update SUMMARY.md in the same change.

Chapter format

One top-level heading (#) per chapter.
Prefer short sections with explicit responsibilities, invariants, and workflows.
Link related terms to glossary.md.
Link to relevant code paths when making concrete claims.

Writing conventions

Follow semantic line breaks for prose.
Prefer active voice and operational wording.
Keep guidance implementation-neutral unless a path is repository-specific.
Clearly separate facts, constraints, and recommendations.

Verification

Before finishing, build the book and report the exact command and result:

mdbook build docs/knowledge-base/