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.

FileKindSize
SKILL.mdskill md1.3 KB
skill-report.jsonconfig16.7 KB
---
name: chapter-analyzer
description: 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:
```yaml
---
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: 322kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall