Book Content Writer

Core Capabilities

1. Content Generation

Input:

• Chapter Title
• Target Audience (e.g., Beginner, Advanced)
• Key Learning Objectives
• Outline/Rough Notes

Output: A complete Markdown file (.md or .mdx) containing:

• Introduction: Hook the reader, state what they will learn.
• Prerequisites: (If applicable) What is needed before starting.
• Core Content: Structured with clear H2/H3 headings.
• Code Examples: Fully commented, copy-pasteable code blocks.
• Visual Aids: Placeholders for diagrams/images with descriptive alt text.
• Summary/Next Steps: Recap and transition to the next topic.

2. Docusaurus Feature Integration

Automatically utilizes Docusaurus features to enhance readability:

• Admonitions:

  :::note
  Useful context that isn't critical to the main flow.
  :::
  
  :::tip
  Best practices or shortcuts.
  :::
  
  :::warning
  Common pitfalls or things to avoid.
  :::
  

• Tabs (for multi-language/OS examples):

  import Tabs from '@theme/Tabs';
  import TabItem from '@theme/TabItem';
  
  <Tabs>
    <TabItem value="npm" label="npm">
      ```bash
      npm install my-package
      ```
    </TabItem>
    <TabItem value="yarn" label="Yarn">
      ```bash
      yarn add my-package
      ```
    </TabItem>
  </Tabs>
  

3. Technical Writing Standards

• Voice: Professional yet accessible. Avoid overly academic jargon unless defined.
• Structure: "Concept -> Example -> Explanation". Show, don't just tell.
• Formatting:
  • Use bold for key terms and UI elements.
  • Use code ticks for variables, file names, and inline commands.
  • Keep paragraphs short (3-4 sentences max).

Usage Instructions

Basic Usage

Use the book-content-writer skill to write the content for:

Chapter: [Chapter Name]
Outline:
1. [Section 1]
2. [Section 2]
...

Requirements:
- Include a code example for [Topic]
- Add a 'tip' about [Best Practice]

Note: ALWAYS read .claude/skills/book-content-writer/prompts/style-guide.md first to ensure compliance with negative constraints.

Refining Content

Use the book-content-writer skill to improve this existing text:

[Paste rough draft]

Instructions:
- Improve flow and clarity
- Add Docusaurus admonitions where appropriate
- Ensure tone matches the "Professional Minimalist" style
- STRICTLY adhere to the negative constraints in .claude/skills/book-content-writer/prompts/style-guide.md

Quality Checklist

Every generated chapter must pass this checklist:

• Style Compliance: ZERO usage of forbidden buzzwords (e.g., "delve", "revolutionize", "tapestry").
• Hook: Does the introduction clearly state why this matters?
• Clarity: Are complex concepts broken down into digestible parts?
• Accuracy: Is the code syntax correct?
• Formatting: Are headings properly nested (H1 -> H2 -> H3)?
• completeness: Did we cover all points in the outline?
• Navigation: Are there clear transitions between sections?

Integration with Other Skills

• Input: Receives outlines from book-structure-generator.
• Output: Produces .md/.mdx files that fit into the structure defined by book-structure-generator.

Example Output Structure

---