Skip to content

aiskillstore/marketplace / skills/abdulsamad94/chapter-analyzer

chapter-analyzer

Verified

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

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

  1. Heading Hierarchy:
    • The Docusaurus title acts as H1.
    • Start content with H2 (##).
    • Do not use H1 (#) within the body.
  2. 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.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall