Claude-skill-registry Chapter Analyzer

Validates and analyzes Docusaurus MDX chapters for structure, pedagogical quality, and component usage.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/chapter-analyzer" ~/.claude/skills/majiayu000-claude-skill-registry-chapter-analyzer && rm -rf "$T"

manifest: skills/data/chapter-analyzer/SKILL.md

Chapter Analyzer Logic

Target Directory

Location:
```
textbook/docs/
```
Format: MDX (
```
.mdx
```
or
```
.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.