book-writer

Coordinate Markdown chapter creation, renaming, and removal across MkDocs site files.

122|30|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/aospbooks/aosp-internal-book --skill book-writer-aospbooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: book-writer
Source: https://github.com/aospbooks/aosp-internal-book/tree/main/.claude/skills/book-writer
Command: npx skills add https://github.com/aospbooks/aosp-internal-book --skill book-writer-aospbooks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating authoring workflows for multi-chapter MkDocs books—keeping chapter templates, navigation, and site configuration consistent across files and tools—can be tedious and error-prone.

Core Features & Use Cases

  • Chapter scaffolding: create NN-slug.md from a standardized template and update navigation in mkdocs.yml.
  • Site maintenance: synchronize docs/ symlinks, llms.txt entries, and agent manifests when chapters are added, removed, or renamed.
  • Diagram and content patterns: enforce Mermaid-diagram guidelines and chapter structure to ensure consistent rendering and navigation.

Quick Start

Create a new NN-slug.md using the chapter template and update mkdocs.yml, docs/ symlink, llms.txt, and the agents manifest before building.

Frequently Asked Questions about book-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize Markdown book chapters for MkDocs?

MkDocs book chapter organization applies standardized templates and naming conventions to Markdown files, coordinating navigation entries and manifests to keep multi-chapter sites consistent and error-free.

What's the best way to maintain mkdocs.yml navigation when adding chapters?

MkDocs navigation maintenance synchronizes mkdocs.yml entries with chapter creation and renaming workflows, automatically updating docs symlinks, llms.txt, and agent manifests alongside navigation.

How do I scaffold a new chapter in a multi-chapter MkDocs book?

Chapter scaffolding creates an NN-slug.md file from a standardized template, enforcing chapter numbering and frontmatter requirements before updating mkdocs.yml and related manifests.

Can I use Mermaid diagrams in MkDocs documentation?

Mermaid diagrams in MkDocs documentation are supported through enforced content patterns and diagram guidelines, ensuring consistent rendering and navigation across multi-chapter books.

How do I keep llms.txt and agent manifests synchronized with Markdown documentation?

Manifest synchronization updates llms.txt entries and agent manifests automatically when chapters are added, removed, or renamed, keeping site configuration consistent across files and tools.

Why does my MkDocs site break when renaming book chapters?

MkDocs site breaks during chapter renaming occur when navigation, docs symlinks, and manifests fall out of sync; coordinated renaming workflows update mkdocs.yml, llms.txt, and agent manifests together to prevent errors.