chapter-analyzer
Docusaurus MDX形式の章構成をチェックし、教育的な質やコンポーネントの利用状況を分析することで、より質の高いドキュメント作成を支援するSkill。
📜 元の英語説明(参考)
Validates and analyzes Docusaurus MDX chapters for structure, pedagogical quality, and component usage.
🇯🇵 日本人クリエイター向け解説
Docusaurus MDX形式の章構成をチェックし、教育的な質やコンポーネントの利用状況を分析することで、より質の高いドキュメント作成を支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o chapter-analyzer.zip https://jpskill.com/download/16937.zip && unzip -o chapter-analyzer.zip && rm chapter-analyzer.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/16937.zip -OutFile "$d\chapter-analyzer.zip"; Expand-Archive "$d\chapter-analyzer.zip" -DestinationPath $d -Force; ri "$d\chapter-analyzer.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
chapter-analyzer.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
chapter-analyzerフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Chapter Analyzer のロジック
対象ディレクトリ
- 場所:
textbook/docs/ - 形式: MDX (
.mdxまたは.md)
構造の検証
すべての章は有効な YAML frontmatter を持っている必要があります。
---
id: my-chapter-id
title: My Chapter Title
sidebar_label: Sidebar Label
description: 章の簡単な要約。
---コンテンツのルール
- 見出しの階層:
- Docusaurus のタイトルは H1 として機能します。
- コンテンツは H2 (
##) から始めてください。 - 本文中で H1 (
#) を使用しないでください。
- 教育的な流れ:
- 導入: 読者の興味を引きつけます。
- 学習目標: 何を学ぶかの箇条書き。
- コアコンテンツ: テキスト + 図/コードで説明します。
- インタラクティブな要素: 主要なセクションごとに少なくとも1つの Quiz または Simulation を含めます。
- まとめ: 主要なポイントを要約します。
インタラクティブなコンポーネント
MDX ではカスタムコンポーネントを使用します。
<Quiz questions={[...]} />: 知識の確認用。<Simulation type="ros2-node" ... />: 埋め込みシミュレーション用。<Tabs>/<TabItem>: 複数言語のコードブロック用 (Python/C++)。
トーンチェック
- 声: 励ますような、権威的だが親しみやすい。
- 視点: 「私たちは学びます」、「探求しましょう」。
- 明瞭さ: 説明なしに専門用語を使用しないでください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Chapter Analyzer Logic
Target Directory
- Location:
textbook/docs/ - Format: MDX (
.mdxor.md)
Structural Validation
Every chapter must have valid YAML frontmatter:
---
id: my-chapter-id
title: My Chapter Title
sidebar_label: Sidebar Label
description: Brief summary of the chapter.
---Content Rules
- Heading Hierarchy:
- The Docusaurus title acts as H1.
- Start content with H2 (
##). - Do not use H1 (
#) within the body.
- Pedagogical Flow:
- Introduction: Hook the reader.
- Learning Objectives: Bullet points on what will be learned.
- Core Content: Explained with text + diagrams/code.
- Interactive Element: At least one Quiz or Simulation per major section.
- Summary: Recap key points.
Interactive Components
We use custom components in MDX:
<Quiz questions={[...]} />: For knowledge checks.<Simulation type="ros2-node" ... />: For embedded simulations.<Tabs>/<TabItem>: For multi-language code blocks (Python/C++).
Tone Check
- Voice: Encouraging, Authoritative but Accessible.
- Perspective: "We will learn", "Let's explore".
- Clarity: Avoid jargon without explanation.