book-writer

Generate structured Quarto documentation across ja/ and en/ directories.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/naoto-iwase/books --skill book-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: book-writer
Source: https://github.com/naoto-iwase/books/tree/main/.claude/skills/book-writer
Command: npx skills add https://github.com/naoto-iwase/books --skill book-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Book authors and technical writers often spend excessive time coordinating drafting, polishing, and structuring large technical documents. This skill automates the end-to-end workflow for turning source material into structured Quarto-style documentation, with parallel supplement generation and rich callouts to keep content consistent.

Core Features & Use Cases

  • Phase-based workflow: Phase 0 preparation, Phase 1 overview drafting (00-overview.qmd), Phase 2 parallel supplement generation, Phase 3 callout enhancement, Phase 4 index/qmd configuration, Phase 5 final checks.
  • Parallel supplementation and cross-reference integration: Sub-agents generate additional context docs and integrate cross-references and callouts in the main document.
  • Language support and repository discipline: Supports ja/ and en/ branches, with standardized file naming (00-overview.qmd, 01-xxx.qmd) and assets/references structure.
  • Quality tooling and formatting: Includes scripts to fix box drawings and spacing, enforce formatting rules, and provide a clear workflow for QA.

Quick Start

  • Provide a new book prompt specifying language and book name; the skill will scaffold ja/{book}/ with required files and starter content, then guide you through Phase 0–Phase 5 to produce a complete, linked document set.

Frequently Asked Questions about book-writer

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

FAQPage Schema
How do I automate multi-language technical book writing with Quarto?

You can automate multi-language technical book writing by running a phase-driven workflow that generates overview and supplement documents across ja/ and en/ directories. The process enforces Quarto-ready front matter, cross-references, and callouts while validating links and formatting.

What is the best way to structure a technical documentation workflow with cross-references and callouts?

Structuring a technical documentation workflow with cross-references and callouts requires a phase-based approach: preparation, overview drafting, parallel supplement generation, callout enhancement, configuration, and final checks. This maintains consistency across all linked documents.

Can I scaffold both Japanese and English directories for a Quarto book project?

Yes, you can scaffold both Japanese and English directories for a Quarto book project. The workflow supports ja/ and en/ branches with standardized file naming like 00-overview.qmd and 01-xxx.qmd, alongside structured assets and references directories.

How do I generate parallel supplement documents for a technical book?

You generate parallel supplement documents for a technical book using sub-agents during Phase 2 of the workflow. These agents create additional context docs and integrate cross-references and callouts directly into the main overview document.

Does the Quarto book writing workflow include formatting and quality checks?

Yes, the Quarto book writing workflow includes formatting and quality checks. It utilizes Phase 5 for final checks, running scripts to fix box drawings, enforce spacing rules, and validate links against established documentation standards.

Why does my technical documentation need a phase-driven generation process?

Your technical documentation needs a phase-driven generation process to prevent excessive manual coordination. It systematically separates drafting, parallel supplement generation, callout enhancement, and final formatting checks to maintain structure and consistency.